ProviderConnectionPoint.GetSecondaryInterfaces(Control) Method

Reference

Definition

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

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

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

abstract member GetSecondaryInterfaces : System.Web.UI.Control -> System.Web.UI.WebControls.WebParts.ConnectionInterfaceCollection
override this.GetSecondaryInterfaces : System.Web.UI.Control -> System.Web.UI.WebControls.WebParts.ConnectionInterfaceCollection

Public Overridable Function GetSecondaryInterfaces (control As Control) As ConnectionInterfaceCollection

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