This documentation is archived and is not being maintained.

WebPartManager.ConnectWebParts Method (WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer)

Note: This method is new in the .NET Framework version 2.0.

Creates a connection between two WebPart or GenericWebPart controls using the references to the controls, their specified ConnectionPoint objects, and a WebPartTransformer object.

Namespace: System.Web.UI.WebControls.WebParts
Assembly: System.Web (in system.web.dll)

public virtual WebPartConnection ConnectWebParts (
	WebPart provider,
	ProviderConnectionPoint providerConnectionPoint,
	WebPart consumer,
	ConsumerConnectionPoint consumerConnectionPoint,
	WebPartTransformer transformer
)
public WebPartConnection ConnectWebParts (
	WebPart provider, 
	ProviderConnectionPoint providerConnectionPoint, 
	WebPart consumer, 
	ConsumerConnectionPoint consumerConnectionPoint, 
	WebPartTransformer transformer
)
public function ConnectWebParts (
	provider : WebPart, 
	providerConnectionPoint : ProviderConnectionPoint, 
	consumer : WebPart, 
	consumerConnectionPoint : ConsumerConnectionPoint, 
	transformer : WebPartTransformer
) : WebPartConnection

Parameters

provider

A WebPart that has the role of furnishing data to another connected control.

providerConnectionPoint

A public method in provider that is marked with a ConnectionProvider metadata attribute, and serves as a callback method for the connection.

consumer

A WebPart that has the role of receiving data from provider or transformer, and then processing or displaying it.

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

A WebPartTransformer that enables a connection between two controls by converting the data from provider to a format that consumer can process.

Return Value

A WebPartConnection that contains the information about the provider, consumer, and transformer needed for a connection.

The ConnectWebParts(WebPart,ProviderConnectionPoint,WebPart,ConsumerConnectionPoint,WebPartTransformer) 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.

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0
Show: