ProviderConnectionPoint.GetSecondaryInterfaces(Control) Method

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Gets an optional collection of secondary interfaces that can be supported by a provider connection point.

C#

public virtual System.Web.UI.WebControls.WebParts.ConnectionInterfaceCollection GetSecondaryInterfaces(System.Web.UI.Control control);

Parameters

control

Control

The control acting as the provider in a Web Parts connection.

Returns

ConnectionInterfaceCollection

A ConnectionInterfaceCollection of additional interfaces provided by the control acting as a provider.

Remarks

A provider connection point object always has a default interface that is used to establish a connection with consumers. An instance of the default interface is retrieved by calling the GetObject method on a ProviderConnectionPoint object.

However, some provider controls will implement multiple interfaces to provide to consumers as part of a connection. These interfaces, which are not the default ones used to establish a connection, are called secondary interfaces. The GetSecondaryInterfaces method provides a way to return a collection of references to the secondary interfaces, just as the GetObject method returns a reference to the default interface.

Notes to Inheritors

The GetSecondaryInterfaces(Control) method in the ProviderConnectionPoint class contains no implementation; it returns an empty collection of secondary interfaces. To implement this method, you must inherit from the ProviderConnectionPoint class, and override this method, returning from it a specific set of secondary interfaces.

Applies to