Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

XpsDocument.SignDigitally Method (X509Certificate, Boolean, XpsDigSigPartAlteringRestrictions, Guid, Boolean)

Signs a collection of package parts with a specified X.509 certificate.

Namespace:  System.Windows.Xps.Packaging
Assembly:  ReachFramework (in ReachFramework.dll)

public XpsDigitalSignature SignDigitally(
	X509Certificate certificate,
	bool embedCertificate,
	XpsDigSigPartAlteringRestrictions restrictions,
	Guid id,
	bool testIsSignable
)

Parameters

certificate
Type: System.Security.Cryptography.X509Certificates.X509Certificate

The X.509 certificate to use in signing each part; or null to prompt the user to select an installed certificate.

embedCertificate
Type: System.Boolean

true to store the certificate in the package; otherwise, false.

restrictions
Type: System.Windows.Xps.Packaging.XpsDigSigPartAlteringRestrictions

Flags that indicate what dependent parts to exclude from the signing.

id
Type: System.Guid

The ID to assign to the signature.

testIsSignable
Type: System.Boolean

true to verify that IsSignable is true before signing; otherwise, false.

Return Value

Type: System.Windows.Xps.Packaging.XpsDigitalSignature
An XpsDigitalSignature that contains information about the signature.

If certificate is null, a dialog box is presented that enables the user to select an installed X.509 certificate, such as from a smart card reader.

CryptographicException is thrown if certificate is null and no certificates are installed.

The following example shows how to use the SignDigitally method.


        // ------------------------------ SignXps ----------------------------- 
        /// <summary> 
        ///   Signs an XPS document with a given X509 certificate, and if one 
        ///   exists, associates the signature with a given SignatureDefintion 
        ///   spotId GUID.</summary> 
        /// <param name="xpsDocument">
        ///   The XPS document to sign.</param> 
        /// <param name="cert">
        ///   The X509 certificate to use for signing.</param> 
        /// <param name="spotId">
        ///   The nullable spotId GUID of the signature definition.</param> 
        public void SignXps(
            XpsDocument xpsDocument, X509Certificate cert, Guid? spotId )
        {
            // If there's a SignatureDefinition spotId, 
            // associate it with the signature. 
            if (spotId != null)
            {
                xpsDocument.SignDigitally(
                    cert, true, XpsDigSigPartAlteringRestrictions.None,
                    spotId.Value);
            }
            else
            {
                xpsDocument.SignDigitally(
                    cert, true, XpsDigSigPartAlteringRestrictions.None);
            }

        }// end:SignXps()

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft