ProviderConnectionPoint.GetSecondaryInterfaces(Control) Method

Definition

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

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