ConnectionConsumerAttribute 构造函数

定义

命名空间:

System.Web.UI.WebControls.WebParts

程序集:

System.Web.dll

初始化 ConnectionConsumerAttribute 类的新实例，指定一个值用作连接点显示名称，还可以选择指定一些值用作连接点的 ID 和/或连接点类型。

重载

ConnectionConsumerAttribute(String)	初始化 ConnectionConsumerAttribute 类的新实例，为使用者连接点指定显示名称。
ConnectionConsumerAttribute(String, String)	初始化 ConnectionConsumerAttribute 类的新实例，为使用者连接点指定显示名称和 ID。
ConnectionConsumerAttribute(String, Type)	初始化 ConnectionConsumerAttribute 类的新实例，指定使用者连接点所使用的显示名称和特定连接点对象类型。
ConnectionConsumerAttribute(String, String, Type)	初始化 ConnectionConsumerAttribute 类的新实例，指定显示名称、ID 以及用于使用者连接点的连接点对象的特定类型。

注解

使用者控件可以使用元数据元素标记 ConnectionConsumerAttribute 多个方法。 在这种情况下，使用者将有多个连接点，并且元素的每个实例 ConnectionConsumerAttribute 都应为关联的连接点指定唯一的 ID 值，以便可以区分使用者的连接点。

ConnectionConsumerAttribute(String)

初始化 ConnectionConsumerAttribute 类的新实例，为使用者连接点指定显示名称。

public:
 ConnectionConsumerAttribute(System::String ^ displayName);

public ConnectionConsumerAttribute (string displayName);

new System.Web.UI.WebControls.WebParts.ConnectionConsumerAttribute : string -> System.Web.UI.WebControls.WebParts.ConnectionConsumerAttribute

Public Sub New (displayName As String)

参数

displayName

String

一个字符串，该字符串包含使用者连接点在用户界面 (UI) 中显示的友好名称。

例外

ArgumentNullException

displayName 为 null。

示例

下面的代码示例演示如何使用 ConnectionConsumerAttribute 类，演示如何在使用者控件的回调方法上声明 ConnectionConsumerAttribute 元数据元素。 请注意，使用构造函数的最简单重载; displayName 仅提供参数值。 有关运行代码示例所需的完整代码，请参阅 ConnectionConsumerAttribute 类概述。

[ConnectionConsumer("Row")]
public void SetConnectionInterface(IWebPartRow provider) 
{
    _provider = provider;
}

    <ConnectionConsumer("Row")> _
    Public Sub SetConnectionInterface(ByVal provider As IWebPartRow)
        _provider = provider

    End Sub
End Class

注解

此构造函数创建一个特性的实例，该实例与充当使用者的Web 部件控件的方法一起使用。 此方法将成为提供程序与使用者之间的连接点。 通常，使用此构造函数的方式是在想要在使用者控件中指定为回调方法的方法上声明 ConnectionConsumerAttribute 元数据元素。

该 displayName 参数是控件用来 ConnectionsZone 表示 UI 中的使用者连接点的使用者连接点的友好名称。

另请参阅

• DisplayName

ConnectionConsumerAttribute(String, String)

初始化 ConnectionConsumerAttribute 类的新实例，为使用者连接点指定显示名称和 ID。

public:
 ConnectionConsumerAttribute(System::String ^ displayName, System::String ^ id);

public ConnectionConsumerAttribute (string displayName, string id);

new System.Web.UI.WebControls.WebParts.ConnectionConsumerAttribute : string * string -> System.Web.UI.WebControls.WebParts.ConnectionConsumerAttribute

Public Sub New (displayName As String, id As String)

参数

displayName

String

一个字符串，该字符串包含使用者连接点在用户界面 (UI) 中显示的友好名称。

id

String

ID，即分配给使用者连接点的唯一字符串值。

例外

ArgumentNullException

displayName 或 id 为 null。

注解

该 displayName 参数是控件用来 ConnectionsZone 表示 UI 中的使用者连接点的使用者连接点的友好名称。

该 id 参数用于指定与特定回调方法关联的使用者连接点的 ID。 控件可以有多个连接点，但 id 每个连接点必须是唯一的。 因此，如果使用者控件中有多个回调方法，则构造函数的重载非常有用。

另请参阅

• DisplayName
• ID

ConnectionConsumerAttribute(String, Type)

初始化 ConnectionConsumerAttribute 类的新实例，指定使用者连接点所使用的显示名称和特定连接点对象类型。

public:
 ConnectionConsumerAttribute(System::String ^ displayName, Type ^ connectionPointType);

public ConnectionConsumerAttribute (string displayName, Type connectionPointType);

new System.Web.UI.WebControls.WebParts.ConnectionConsumerAttribute : string * Type -> System.Web.UI.WebControls.WebParts.ConnectionConsumerAttribute

Public Sub New (displayName As String, connectionPointType As Type)

参数

displayName

String

一个字符串，该字符串包含使用者连接点在用户界面 (UI) 中显示的友好名称。

connectionPointType

Type

一个派生自 ConsumerConnectionPoint，且你希望将其指定为连接点对象的类型以与特定的回调方法一起使用的 Type。

例外

ArgumentNullException

displayName 或 connectionPointType 为 null。

ArgumentException

connectionPointType 无效。

注解

该 displayName 参数是控件用来 ConnectionsZone 表示 UI 中的使用者连接点的使用者连接点的友好名称。

参数 connectionPointType 必须是 Type 派生自 ConsumerConnectionPoint. 如果指定此参数，则Type用于创建连接点而不是随Web 部件控件集提供的标准ConsumerConnectionPoint类。

另请参阅

• ConnectionPointType
• DisplayName

ConnectionConsumerAttribute(String, String, Type)

初始化 ConnectionConsumerAttribute 类的新实例，指定显示名称、ID 以及用于使用者连接点的连接点对象的特定类型。

public:
 ConnectionConsumerAttribute(System::String ^ displayName, System::String ^ id, Type ^ connectionPointType);

public ConnectionConsumerAttribute (string displayName, string id, Type connectionPointType);

new System.Web.UI.WebControls.WebParts.ConnectionConsumerAttribute : string * string * Type -> System.Web.UI.WebControls.WebParts.ConnectionConsumerAttribute

Public Sub New (displayName As String, id As String, connectionPointType As Type)

参数

displayName

String

一个字符串，该字符串包含使用者连接点在用户界面 (UI) 中显示的友好名称。

id

String

ID，即分配给使用者连接点的唯一字符串值。

connectionPointType

Type

一个派生自 ConsumerConnectionPoint，且你希望将其指定为连接点对象的类型以与特定的回调方法一起使用的 Type。

例外

ArgumentNullException

displayName、id 或 connectionPointType 为 null。

ArgumentException

connectionPointType 无效。

注解

该 displayName 参数是控件用来 ConnectionsZone 表示 UI 中的使用者连接点的使用者连接点的友好名称。

该 id 参数用于指定与特定回调方法关联的使用者连接点的 ID。 控件可以有多个连接点，但 id 每个连接点必须是唯一的。 因此，如果使用者控件中有多个回调方法，则构造函数的重载非常有用。

参数 connectionPointType 必须是 Type 派生自 ConsumerConnectionPoint. 如果指定此参数，则Type用于创建连接点而不是随Web 部件控件集提供的标准ConsumerConnectionPoint类。

另请参阅

• ConnectionPointType
• DisplayName
• ID