XpsDigSigPartAlteringRestrictions Enumerazione

Definizione

Spazio dei nomi:

System.Windows.Xps.Packaging

Assembly:

ReachFramework.dll

Specifica le parti dell'oggetto Package XPS escluse dall'intervallo di una firma digitale.

Questa enumerazione supporta una combinazione bit per bit dei rispettivi valori dei membri.

public enum class XpsDigSigPartAlteringRestrictions

[System.Flags]
public enum XpsDigSigPartAlteringRestrictions

[<System.Flags>]
type XpsDigSigPartAlteringRestrictions = 

Public Enum XpsDigSigPartAlteringRestrictions

Ereditarietà

Object

ValueType

Enum

XpsDigSigPartAlteringRestrictions

Attributi

FlagsAttribute

Campi

Annotations	2	La parte delle annotazioni è esclusa.
CoreMetadata	1	La parte relativa alle proprietà principali è esclusa.
None	0	Nessuna parte è esclusa.
SignatureOrigin	4	La parte dell'origine della firma è esclusa.

Esempio

Nell'esempio seguente viene illustrato come utilizzare questa enumerazione per firmare digitalmente un documento 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

Commenti

Questa enumerazione ha un FlagsAttribute che consente una combinazione bit per bit dei relativi valori membro.

Le parti specificate come escluse dalla firma digitale possono essere modificate senza invalidare la firma. Ad esempio, se un documento deve essere firmato da più di una persona, la parte SignatureOrigin deve essere esclusa dalla firma quando il documento viene firmato per la prima volta. Le esclusioni vengono specificate nel restrictions parametro della chiamata a SignDigitally. Se la parte SignatureOrigin non è esclusa, eventuali firme aggiuntive invalidano la firma del primo firmatario.

Per altre informazioni sulle firme digitali, vedere Digital Signing Framework of the Open Packaging Conventions.For more information about digital signatures, see Digital Signing Framework of the Open Packaging Conventions.

Per altre informazioni sulle parti Principali proprietà e origine della firma, vedere il capitolo 3 della specifica Open Packaging Conventions disponibile per il download all'indirizzo https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Vedi anche

• SignDigitally
• PackageDigitalSignature
• Specifica OPC (Open Packaging Conventions)
• XML Paper Specification (XPS)