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.WebPartConnectionA 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