System.Security.Cryptography.Xml.TransformChain Class

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

See Also: TransformChain Members

Syntax

public class TransformChain

Remarks

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

Use the System.Security.Cryptography.Xml.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 System.Security.Cryptography.Xml.Reference class and the System.Security.Cryptography.Xml.EncryptedReference class contain a System.Security.Cryptography.Xml.TransformChain object. You can add a System.Security.Cryptography.Xml.Transform object to the System.Security.Cryptography.Xml.Reference class by calling the Reference.AddTransform(Transform) method. You can add a System.Security.Cryptography.Xml.Transform object to the System.Security.Cryptography.Xml.EncryptedReference class by calling the EncryptedReference.AddTransform(Transform) method. You can also create a System.Security.Cryptography.Xml.TransformChain object manually and pass it to either the Reference.TransformChain property or the EncryptedReference.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 Reference.Uri property and the EncryptedReference.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/.

Requirements

Namespace: System.Security.Cryptography.Xml
Assembly: System.Security (in System.Security.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0, 4.0.0.0