PackageDigitalSignatureManager.CertificateOption Property

Gets or sets the X.509 certificate embedding option used by the Sign method to digitally sign package parts.

Namespace: System.IO.Packaging
Assembly: WindowsBase (in windowsbase.dll)

public CertificateEmbeddingOption CertificateOption { get; set; }
/** @property */
public CertificateEmbeddingOption get_CertificateOption ()

/** @property */
public void set_CertificateOption (CertificateEmbeddingOption value)

public function get CertificateOption () : CertificateEmbeddingOption

public function set CertificateOption (value : CertificateEmbeddingOption)

You cannot use this property in XAML.

Property Value

One of the CertificateEmbeddingOption values.

This property specifies where the signer's X.509 certificate will be stored when digitally signing a part.

X.509 certificates used to sign and validate a XML Paper Specification (XPS) package parts can be stored in one of three locations:


In its own certificate PackagePart within the package.

The X.509 certificate can be obtained through the Signer property.


Within the content of the SignaturePart in the package.

The X.509 certificate can be obtained through the Signer property.


External to the package in a location known by both the application creating the signature and the application later using the signature for validation.

The following example shows how to set this property in preparation to digitally sign the parts within a package. For the complete sample, see Creating a Package with a Digital Signature Sample.

// Create the DigitalSignature Manager
PackageDigitalSignatureManager dsm =
    new PackageDigitalSignatureManager(package);
dsm.CertificateOption =

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0

Community Additions