WebPartManager::ConnectWebParts Method (WebPart^, ProviderConnectionPoint^, WebPart^, ConsumerConnectionPoint^, WebPartTransformer^)
Creates a connection between two WebPart or GenericWebPart controls using the references to the controls, their specified ConnectionPoint objects, and a WebPartTransformer object.
Assembly: System.Web (in System.Web.dll)
public: virtual WebPartConnection^ ConnectWebParts( WebPart^ provider, ProviderConnectionPoint^ providerConnectionPoint, WebPart^ consumer, ConsumerConnectionPoint^ consumerConnectionPoint, WebPartTransformer^ transformer )
Parameters
- provider
-
Type:
System.Web.UI.WebControls.WebParts::WebPart^
A WebPart that has the role of furnishing data to another connected control.
- providerConnectionPoint
-
Type:
System.Web.UI.WebControls.WebParts::ProviderConnectionPoint^
A public method in provider that is marked with a ConnectionProvider metadata attribute, and serves as a callback method for the connection.
- consumer
-
Type:
System.Web.UI.WebControls.WebParts::WebPart^
A WebPart that has the role of receiving data from provider or transformer, and then processing or displaying it.
- consumerConnectionPoint
-
Type:
System.Web.UI.WebControls.WebParts::ConsumerConnectionPoint^
A public method in consumer that is marked with a ConnectionConsumer metadata attribute, and connects with providerConnectionPoint to receive the data for the connection.
- transformer
-
Type:
System.Web.UI.WebControls.WebParts::WebPartTransformer^
A WebPartTransformer that enables a connection between two controls by converting the data from provider to a format that consumer can process.
Return Value
Type: System.Web.UI.WebControls.WebParts::WebPartConnection^A WebPartConnection that contains the information about the provider, consumer, and transformer needed for a connection.
| Exception | Condition |
|---|---|
| InvalidOperationException | Connections have already been activated in PreRender. |
This overload is used to connect controls when their connection points are incompatible. The incompatibility occurs when consumer implements a different interface than provider as its connection point. The transformer converts the data into a type that can be understood by consumer.
Available since 2.0