XpsDigSigPartAlteringRestrictions Enum
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
- Atribut
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/.
