Programming .NET Security

Name

Reference

Synopsis

public class Reference {
// Public Constructors
   public Reference(  );
   public Reference(System.IO.Stream stream);
   public Reference(string uri);
// Public Instance Properties
   public string DigestMethod{set; get; }
   public byte[  ] DigestValue{set; get; }
   public string Id{set; get; }
   public TransformChain TransformChain{get; }
   public string Type{set; get; }
   public string Uri{set; get; }
// Public Instance Methods
   public void AddTransform(Transform transform);
   public XmlElement GetXml(  );
   public void LoadXml(System.Xml.XmlElement value);
}

Instances of this class act as a reference to the signed data, expressed as a URI (using the Uri property) or as a local reference to an instance of the DataObject class (using the Id property). References are associated with a signature through the SignedXml.AddReference( ) method.

Implementations of the Transform class can be added to a reference with the AddTransform( ) method; the transformations will be applied in order before the data is signed. The algorithm used to create the cryptographic hash code is set with the DigestMethod property—the default value is http://www.w3.org/2000/09/xmldsig#sha1, which specifies the SHA-1 hash algorithm.

Passed To

SignedInfo.AddReference( ), SignedXml.AddReference( )