This documentation is archived and is not being maintained.

RowToFieldTransformer Class

Transforms data in a Web Parts connection from a provider that implements the IWebPartRow interface to a consumer expecting data through the IWebPartField interface.

System::Object
  System.Web.UI.WebControls.WebParts::WebPartTransformer
    System.Web.UI.WebControls.WebParts::RowToFieldTransformer

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

[WebPartTransformerAttribute(typeof(IWebPartRow), typeof(IWebPartField))]
public ref class RowToFieldTransformer sealed : public WebPartTransformer, 
	IWebPartField

The RowToFieldTransformer type exposes the following members.

  NameDescription
Public methodRowToFieldTransformerInitializes a new instance of the RowToFieldTransformer class.
Top

  NameDescription
Public propertyFieldNameGets or sets the name of the value to transform.
Top

  NameDescription
Public methodCreateConfigurationControlDisplays an ASP.NET control that configures a RowToFieldTransformer transformer in the ConnectionsZone zone. (Overrides WebPartTransformer::CreateConfigurationControl().)
Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodLoadConfigurationStateLoads the configuration state saved with the SaveConfigurationState method. (Inherited from WebPartTransformer.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Protected methodSaveConfigurationStateSaves the configuration state set by the user in the ASP.NET configuration control. (Inherited from WebPartTransformer.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Public methodTransformProvides an object for transforming the data. (Overrides WebPartTransformer::Transform(Object).)
Top

  NameDescription
Explicit interface implemetationPrivate methodIWebPartField::GetFieldValueReturns the value of the field that is being used by the interface as the basis of a connection between two Web Parts controls.
Explicit interface implemetationPrivate propertyIWebPartField::SchemaGets the schema information for a data field that is used to share data between two Web Parts controls.
Top

Transformers are used to translate data between two Web Parts controls with incompatible connection points. A RowToFieldTransformer object transforms data from a provider implementing the IWebPartRow interface to a consumer requiring data from the IWebPartField interface. The RowToFieldTransformer class allows controls with these incompatible connection points to be connected.

The following code example demonstrates how to use a RowToFieldTransformer object to connect a provider and consumer with incompatible connection points. The first section of the example shows a Web Parts control that serves as a provider. The provider class, named RowProviderWebPart, provides data through the IWebPartRow interface.

No code example is currently available or this language may not be supported.

The second section of the example contains a Web Parts control that is a consumer of a Web Parts connection. The consumer class, named FieldConsumerWebPart, expects data from the IWebPartField interface.

No code example is currently available or this language may not be supported.

The third section of the example shows a page that contains the two controls and defines the RowToFieldTransformer object for connecting the two controls.

No code example is currently available or this language may not be supported.

The code example includes a user control that enables you to change display modes on a Web Parts page. The source code for the user control comes from another topic. You can obtain the .ascx file for the user control from Walkthrough: Changing Display Modes on a Web Parts Page, and it must be placed in the same folder as the .aspx page.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show: