XpsDigSigPartAlteringRestrictions Enumeration

Definition

Gibt die Parts des XPS Package an, die aus dem Bereich einer digitalen Signatur ausgeschlossen werden.

Diese Enumeration unterstützt eine bitweise Kombination ihrer Memberwerte.

public enum class XpsDigSigPartAlteringRestrictions
[System.Flags]
public enum XpsDigSigPartAlteringRestrictions
[<System.Flags>]
type XpsDigSigPartAlteringRestrictions = 
Public Enum XpsDigSigPartAlteringRestrictions
Vererbung
XpsDigSigPartAlteringRestrictions
Attribute

Felder

Annotations 2

Das Annotations-Part wird ausgeschlossen.

CoreMetadata 1

Das Core Properties-Part wird ausgeschlossen.

None 0

Es werden keine Parts ausgeschlossen.

SignatureOrigin 4

Das Signature Origin-Part wird ausgeschlossen.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie diese Aufzählung verwenden, um ein XPS-Dokument digital zu signieren.


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

Hinweise

Diese Enumeration verfügt über ein FlagsAttribute, das eine bitzeiger Kombination seiner Memberwerte ermöglicht.

Teile, die von der digitalen Signatur ausgeschlossen sind, können ohne ungültige Signatur geändert werden. Wenn z. B. ein Dokument von mehr als einer Person signiert werden soll, muss der SignatureOrigin-Teil beim ersten Signierten aus der Signatur ausgeschlossen werden. (Ausschlüsse werden im restrictions Parameter des Aufrufs von SignDigitally.) angegeben. Wenn der SignatureOrigin-Teil nicht ausgeschlossen ist, werden alle zusätzlichen Signaturen die Signatur des ersten Signers ungültig.

Weitere Informationen zu digitalen Signaturen finden Sie unter Digital Sign Framework der Open Packaging-Konventionen.

Weitere Informationen zu den Komponenten "Kerneigenschaften" und "Signature Origin" finden Sie in Kapitel 3 der Spezifikation " Open Packaging Convention ", die zum Download https://www.ecma-international.org/publications-and-standards/standards/ecma-376/zur Verfügung steht.

Gilt für

Siehe auch