ConnectionPoint.DisplayName 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取一个字符串,该字符串用作在用户界面 (UI) 中表示连接点的友好显示名称。
public:
property System::String ^ DisplayName { System::String ^ get(); };
public string DisplayName { get; }
member this.DisplayName : string
Public ReadOnly Property DisplayName As String
属性值
一个字符串,包含 ConnectionPoint 对象的友好显示名称。
注解
若要创建 Web 部件连接,连接的提供程序和使用者控件必须分别指定至少一个连接点,这是一种使它们能够通信和共享数据的方法。 为了标识这些连接点方法,开发人员在所选方法上指定一个属性。 在提供程序中, ConnectionProvider
属性在所选回调方法上设置,在使用者中, ConnectionConsumer
在方法上设置特性,该方法接收接口实例,其中包含来自提供程序的数据。 对于这两个属性,无论声明了哪个重载来创建特性,始终都需要的一个参数是 displayName
参数。 开发人员必须分配一个字符串作为连接点的友好显示名称,该字符串将成为 属性的值 DisplayName 。
DisplayName当用户创建连接时,属性值将显示在网页的 UI 中。 例如,当控件 ConnectionsZone 添加到页面时,它会创建一个 UI,供用户创建控件之间的连接。 用户将页面切换到连接显示模式并单击控件上的 WebPart 连接谓词后,将显示连接 UI。 可以参与连接的每个控件都列在 UI 中,每个控件旁边是一个下拉列表控件,该控件显示其可用连接点的友好名称。 用户必须至少选择一个连接点才能建立连接。 连接点列表中显示的值是从 DisplayName 属性获取的。 如果开发人员生成用于创建连接的自定义 UI,则可以以类似的方式使用 DisplayName 属性来提供表示连接点的友好名称。