System.Security.Cryptography.Xml.XmlDsigExcC14NTransform Class

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

See Also: XmlDsigExcC14NTransform Members

Syntax

public class XmlDsigExcC14NTransform : Transform

Remarks

The System.Security.Cryptography.Xml.XmlDsigExcC14NTransform class represents the exclusive C14N XML canonicalization transform without comments. This class is similar to the System.Security.Cryptography.Xml.XmlDsigC14NTransform class, which allows a signer to create a digest using the canonical form of an XML document. However, the System.Security.Cryptography.Xml.XmlDsigExcC14NTransform class excludes ancestor context from a canonicalized subdocument.

Use the System.Security.Cryptography.Xml.XmlDsigC14NTransform class when you need to canonicalize an XML subdocument so that it is independent from its XML context. For example, applications such as Web services that use signed XML within complex communication protocols often need to canonicalize XML in this manner. Such applications often envelop XML within various dynamically constructed elements, which can substantially change the document and cause XML signature verification to fail. The System.Security.Cryptography.Xml.XmlDsigExcC14NTransform class solves this problem by excluding such ancestor context from the canonical subdocument.

Typically, you do not create a new instance of a canonicalization transform class. To specify a canonicalization transform, pass the Uniform Resource Identifier (URI) that describes a 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.

You are required to create a new instance of a canonicalization transform class only when you want to manually hash an XML document or use your own canonicalization algorithm.

The URI that describes the System.Security.Cryptography.Xml.XmlDsigExcC14NWithCommentsTransform class is defined by the SignedXml.XmlDsigExcC14NWithCommentsTransformUrl field.

The URI that describes the System.Security.Cryptography.Xml.XmlDsigExcC14NTransform class is defined by the SignedXml.XmlDsigExcC14NTransformUrl field.

For more information about the exclusive C14N transform, see 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/2001/10/xml-exc-c14n.

Requirements

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