ConnectionProviderAttribute 构造函数

定义

命名空间:

System.Web.UI.WebControls.WebParts

程序集:

System.Web.dll

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

重载

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

注解

提供程序控件可以有多个用 ConnectionProviderAttribute 元数据元素标记的方法。 在这种情况下，提供程序将具有多个连接点，元素的每个实例 ConnectionProviderAttribute 应为关联的连接点指定唯一的 ID 值，以便可以区分提供程序的连接点。

ConnectionProviderAttribute(String)

初始化 ConnectionProviderAttribute 类的新实例，为提供者连接点指定显示名称。

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

public ConnectionProviderAttribute (string displayName);

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

Public Sub New (displayName As String)

参数

displayName

String

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

例外

ArgumentNullException

displayName 为 null。

示例

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

[ConnectionProvider("Row")]
public IWebPartRow GetConnectionInterface()
{
    return new RowProviderWebPart();
}

<ConnectionProvider("Row")> _
Public Function GetConnectionInterface() As IWebPartRow
    Return New RowProviderWebPart()

End Function 'GetConnectionInterface

注解

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

参数 displayName 是提供程序连接点的友好名称，控件 ConnectionsZone 使用该名称在 UI 中表示提供程序的连接点。

另请参阅

• DisplayName

ConnectionProviderAttribute(String, String)

初始化 ConnectionProviderAttribute 类的新实例，为提供者连接点指定显示名称和 ID。

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

public ConnectionProviderAttribute (string displayName, string id);

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

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

ConnectionProviderAttribute(String, Type)

初始化 ConnectionProviderAttribute 类的新实例，指定用于提供者连接点的连接点对象的显示名称和特定类型。

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

public ConnectionProviderAttribute (string displayName, Type connectionPointType);

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

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

参数

displayName

String

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

connectionPointType

Type

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

例外

ArgumentNullException

displayName 或 connectionPointType 为 null。

ArgumentException

connectionPointType 无效。

注解

参数 displayName 是提供程序连接点的友好名称，控件 ConnectionsZone 使用该名称在 UI 中表示提供程序的连接点。

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

另请参阅

• ConnectionPointType
• DisplayName

ConnectionProviderAttribute(String, String, Type)

初始化 ConnectionProviderAttribute 类的新实例，指定显示名称、ID 以及用于提供程序连接点的连接点对象的特定类型。

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

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

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

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

参数

displayName

String

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

id

String

ID，即分配给提供程序连接点的唯一字符串值。

connectionPointType

Type

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

例外

ArgumentNullException

displayName、id 或 connectionPointType 为 null。

ArgumentException

connectionPointType 无效。

注解

参数 displayName 是提供程序连接点的友好名称，控件 ConnectionsZone 使用该名称在 UI 中表示提供程序的连接点。

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

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

另请参阅

• ConnectionPointType
• DisplayName
• ID