XpsDigSigPartAlteringRestrictions Enum

Definisi

Ruang nama:

System.Windows.Xps.Packaging

Rakitan:

ReachFramework.dll

Menentukan bagian XPS Package yang dikecualikan dari rentang tanda tangan digital.

Enumerasi ini mendukung kombinasi bitwise dari nilai yang termasuk di dalamnya.

public enum class XpsDigSigPartAlteringRestrictions

[System.Flags]
public enum XpsDigSigPartAlteringRestrictions

[<System.Flags>]
type XpsDigSigPartAlteringRestrictions = 

Public Enum XpsDigSigPartAlteringRestrictions

Warisan

Object

ValueType

Enum

XpsDigSigPartAlteringRestrictions

Atribut

FlagsAttribute

Bidang

Annotations	2	Bagian Anotasi dikecualikan.
CoreMetadata	1	Bagian Properti Inti dikecualikan.
None	0	Tidak ada bagian yang dikecualikan.
SignatureOrigin	4	Bagian Asal Tanda Tangan dikecualikan.

Contoh

Contoh berikut menunjukkan cara menggunakan enumerasi ini untuk menandatangani dokumen XPS secara digital.

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

Keterangan

Enumerasi ini memiliki FlagsAttribute yang memungkinkan kombinasi bitwise dari nilai anggotanya.

Bagian yang ditentukan sebagai dikecualikan dari tanda tangan digital dapat dimodifikasi tanpa membatalkan tanda tangan. Misalnya, jika dokumen akan ditandatangani oleh lebih dari satu orang, bagian SignatureOrigin perlu dikecualikan dari tanda tangan saat dokumen pertama kali ditandatangani. (Pengecualian ditentukan dalam restrictions parameter panggilan ke SignDigitally.) Jika bagian SignatureOrigin tidak dikecualikan, tanda tangan tambahan apa pun membatalkan tanda tangan penanda tangan pertama.

Untuk informasi selengkapnya tentang tanda tangan digital, lihat Kerangka Kerja Penandatanganan Digital dari Konvensi Kemasan Terbuka.

Untuk informasi selengkapnya tentang Properti Inti dan bagian Asal Tanda Tangan, lihat Bab 3 spesifikasi Konvensi Kemasan Terbuka yang tersedia untuk diunduh di https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Lihat juga

• SignDigitally
• PackageDigitalSignature
• Spesifikasi Open Packaging Conventions (OPC)
• Spesifikasi Kertas XML (XPS)