XpsDigSigPartAlteringRestrictions Énumération

Définition

Spécifie les parties du Package XPS qui sont exclues de la plage d’une signature numérique.

Cette énumération prend en charge une combinaison au niveau du bit de ses valeurs membres.

public enum class XpsDigSigPartAlteringRestrictions
[System.Flags]
public enum XpsDigSigPartAlteringRestrictions
[<System.Flags>]
type XpsDigSigPartAlteringRestrictions = 
Public Enum XpsDigSigPartAlteringRestrictions
Héritage
XpsDigSigPartAlteringRestrictions
Attributs

Champs

Annotations 2

La partie Annotations est exclue.

CoreMetadata 1

La partie Core Properties est exclue.

None 0

Aucune partie n'est exclue.

SignatureOrigin 4

La partie Signature Origin est exclue.

Exemples

L’exemple suivant montre comment utiliser cette énumération pour signer numériquement un document XPS.


// ------------------------------ 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()

' ------------------------------ 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 Sub SignXps(xpsDocument As XpsDocument, cert As X509Certificate, spotId? As Guid)
    ' If there's a SignatureDefinition spotId,
    ' associate it with the signature.
    If spotId IsNot Nothing Then
        xpsDocument.SignDigitally(cert, True, XpsDigSigPartAlteringRestrictions.None, spotId.Value)
    Else
        xpsDocument.SignDigitally(cert, True, XpsDigSigPartAlteringRestrictions.None)
    End If

End Sub

Remarques

Cette énumération a un FlagsAttribute qui permet une combinaison au niveau du bit de ses valeurs membres.

Les parties spécifiées comme exclues de la signature numérique peuvent être modifiées sans invalider la signature. Par exemple, si un document doit être signé par plusieurs personnes, la partie SignatureOrigin doit être exclue de la signature lorsque le document est signé pour la première fois. (Les exclusions sont spécifiées dans le restrictions paramètre de l’appel à SignDigitally.) Si la partie SignatureOrigin n’est pas exclue, toutes les signatures supplémentaires invalident la signature du premier signataire.

Pour plus d’informations sur les signatures numériques, consultez Digital Signing Framework of the Open Packaging Conventions.

Pour plus d’informations sur les principales propriétés et les parties d’origine de signature, consultez le chapitre 3 de la spécification Open Packaging Conventions disponible en téléchargement à l’adresse https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

S’applique à

Voir aussi