WebPartConnection.Transformer Property

Gets a WebPartTransformer object that is used to transform data between two otherwise incompatible connection points in a Web Parts connection.

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

public:
property WebPartTransformer^ Transformer {
	WebPartTransformer^ get ();
}
/** @property */
public WebPartTransformer get_Transformer ()

public function get Transformer () : WebPartTransformer

Not applicable.

Property Value

A WebPartTransformer. The default value is a null reference (Nothing in Visual Basic).

In a Web Parts connection, there are two ways in which the provider and consumer controls in the connection can connect. They can connect directly, through their respective ConnectionPoint objects and an interface type that is understood by both controls. Or, if they are incompatible, they can connect indirectly, using a WebPartTransformer object that transforms an interface instance from a provider into a type understood by a consumer.

When a transformer is needed as part of a connection, the Transformer property provides a reference to the WebPartTransformer object. You can add a transformer for a connection declaratively in the markup of a Web page, by adding a tag for a custom transformer (or one of the transformers provided with the Web Parts control set) within the <asp:WebPartConnection> element. You can also add a transformer programmatically, creating an instance of it in your code, and calling the ConnectWebParts(WebPart,ProviderConnectionPoint,WebPart,ConsumerConnectionPoint,WebPartTransformer) method on the WebPartManager control to create the connection, passing to it the transformer object along with the other required parameters.

Windows 98, Windows Server 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 Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show: