System.Security.Cryptography.Xml.XmlDsigC14NTransform Class

Represents the C14N XML canonicalization transform for a digital signature as defined by the World Wide Web Consortium (W3C), without comments.

See Also: XmlDsigC14NTransform Members

Syntax

public class XmlDsigC14NTransform : Transform

Remarks

The System.Security.Cryptography.Xml.XmlDsigC14NTransform class represents the C14N XML canonicalization transform that describes the canonical form of an XML document. This transform allows a signer to create a digest (used to create a digital signature) using the canonical form of an XML document. A recipient can then verify the XML digital signature using the same canonical form of the XML document with the same transform.

Use the System.Security.Cryptography.Xml.XmlDsigC14NTransform class when you need to sign an XML document that does not contain comments.

In most cases, a new instance of a canonicalization transform class is not required. To specify a canonicalization transform, pass the Uniform Resource Identifier (URI) that describes the transform to the SignedInfo.CanonicalizationMethod property, which is accessible from the SignedXml.SignedInfo property. To acquire a reference to the canonicalization transform, use the SignedInfo.CanonicalizationMethodObject property, which is accessible from the SignedXml.SignedInfo property.

The URI that describes the System.Security.Cryptography.Xml.XmlDsigC14NTransform class is defined by the SignedXml.XmlDsigC14NTransformUrl field and the SignedXml.XmlDsigCanonicalizationUrl field.

You would only need to create a new instance of a canonicalization transform class for manually hashing an XML document or for using your own canonicalization algorithm.

For more information about the C14N transform, see Sections 6.5 and 6.6.1 of the XMLDSIG specification, which is available from the World Wide Web Consortium (W3C) at www.w3.org/TR/xmldsig-core/. The canonicalization algorithm is defined in the W3C Canonical XML specification, which is available at www.w3.org/TR/xml-c14n.

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