Export (0) Print
Expand All

TransformChain Class

Defines an ordered list of Transform objects that is applied to unsigned content prior to digest calculation.

System.Object
  System.Security.Cryptography.Xml.TransformChain

Namespace:  System.Security.Cryptography.Xml
Assembly:  System.Security (in System.Security.dll)

[HostProtectionAttribute(SecurityAction.LinkDemand, MayLeakOnAbort = true)]
public class TransformChain

The TransformChain type exposes the following members.

  NameDescription
Public methodTransformChainInitializes a new instance of the TransformChain class.
Top

  NameDescription
Public propertyCountGets the number of transforms in the TransformChain object.
Public propertyItemGets the transform at the specified index in the TransformChain object.
Top

  NameDescription
Public methodAddAdds a transform to the list of transforms to be applied to the unsigned content prior to digest calculation.
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 methodGetEnumeratorReturns an enumerator of the transforms in the TransformChain object.
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

The TransformChain class contains a list of Transform objects that determine how to order XML data before creating a digest.

Use the TransformChain class whenever you need to add one or more transform objects to an encrypted XML document or to a signed XML document.

Both the Reference class and the EncryptedReference class contain a TransformChain object. You can add a Transform object to the Reference class by calling the AddTransform method. You can add a Transform object to the EncryptedReference class by calling the AddTransform method. You can also create a TransformChain object manually and pass it to either the TransformChain property or the TransformChain property.

If you want to sign only a portion of an XML document, you can use a transform to identify the XML elements you intend to sign. Note that the Uri property and the Uri property automatically create internal transforms that allow you to sign a portion of a document.

For more information about transforms, see the XMLDSIG specification, which is available from the W3C at www.w3.org/TR/xmldsig-core/, or see the XML encryption specification, which is available from the W3C at www.w3.org/TR/xmlenc-core/.

NoteNote

The HostProtectionAttribute attribute applied to this type or member has the following Resources property value: MayLeakOnAbort. The HostProtectionAttribute does not affect desktop applications (which are typically started by double-clicking an icon, typing a command, or entering a URL in a browser). For more information, see the HostProtectionAttribute class or SQL Server Programming and Host Protection Attributes.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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:
© 2014 Microsoft