Share via

ConnectionPoint.DisplayName 属性

  • 参考

定义

命名空间:
System.Web.UI.WebControls.WebParts
程序集:
System.Web.dll

获取一个字符串，该字符串用作在用户界面 (UI) 中表示连接点的友好显示名称。

public:
 property System::String ^ DisplayName { System::String ^ get(); };
public string DisplayName { get; }
member this.DisplayName : string
Public ReadOnly Property DisplayName As String

属性值

String

一个字符串，包含 ConnectionPoint 对象的友好显示名称。

注解

若要创建 Web 部件连接，连接的提供程序和使用者控件必须分别指定至少一个连接点，这是一种使它们能够通信和共享数据的方法。 为了标识这些连接点方法，开发人员在所选方法上指定一个属性。 在提供程序中， ConnectionProvider 属性在所选回调方法上设置，在使用者中， ConnectionConsumer 在方法上设置属性，该方法接收接口实例，其中包含来自提供程序的数据。 对于这两个属性，无论声明了哪个重载来创建特性，始终都需要的一个参数是 displayName 参数。 开发人员必须分配一个字符串作为连接点的友好显示名称，该字符串将成为 属性的值 DisplayName 。

DisplayName当用户创建连接时，属性值将显示在网页的 UI 中。 例如，当控件 ConnectionsZone 添加到页面时，它会创建一个 UI，供用户创建控件之间的连接。 用户将页面切换到连接显示模式并单击控件上的 WebPart 连接谓词后，将显示连接 UI。 可以参与连接的每个控件都列在 UI 中，每个控件旁边是一个下拉列表控件，该控件显示其可用连接点的友好名称。 用户必须至少选择一个连接点才能建立连接。 连接点列表中显示的值是从 DisplayName 属性获取的。 如果开发人员生成用于创建连接的自定义 UI，则可以以类似的方式使用 DisplayName 属性来提供表示连接点的友好名称。

适用于

另请参阅