XpsDigSigPartAlteringRestrictions Enumerazione
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
- Attributi
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/.
