XpsDigSigPartAlteringRestrictions Wyliczenie

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Xps.Packaging
Zestaw:
ReachFramework.dll

Określa części XPS Package , które są wykluczone z zakresu podpisu cyfrowego.

To wyliczenie obsługuje bitową kombinację jego wartości składowych.

public enum class XpsDigSigPartAlteringRestrictions
[System.Flags]
public enum XpsDigSigPartAlteringRestrictions
[<System.Flags>]
type XpsDigSigPartAlteringRestrictions = 
Public Enum XpsDigSigPartAlteringRestrictions
Dziedziczenie
Object
ValueType
Enum
XpsDigSigPartAlteringRestrictions
Atrybuty
FlagsAttribute

Pola

Annotations 2

Część Adnotacje jest wykluczona.
CoreMetadata 1

Część Właściwości podstawowe jest wykluczona.
None 0

Nie są wykluczone żadne części.
SignatureOrigin 4

Część Źródło podpisu jest wykluczona.

Przykłady

W poniższym przykładzie pokazano, jak używać tego wyliczenia do cyfrowego podpisywania dokumentu 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

Uwagi

Ta wyliczenie ma atrybut FlagsAttribute, który umożliwia bitową kombinację wartości składowych.

Części określone jako wykluczone z podpisu cyfrowego można modyfikować bez unieważniania podpisu. Jeśli na przykład dokument ma zostać podpisany przez więcej niż jedną osobę, część SignatureOrigin musi zostać wykluczona z podpisu po pierwszym podpisaniu dokumentu. (Wykluczenia są określone w restrictions parametrze wywołania metody SignDigitally.) Jeśli część SignatureOrigin nie zostanie wykluczona, wszelkie dodatkowe podpisy unieważniają podpis pierwszego osoby podpisowej.

Aby uzyskać więcej informacji na temat podpisów cyfrowych, zobacz Digital Signing Framework of the Open Packaging Conventions (Struktura podpisywania cyfrowego konwencji open packaging).

Aby uzyskać więcej informacji na temat podstawowych właściwości i części pochodzenia podpisu, zobacz Rozdział 3 specyfikacji Open Packaging Conventions dostępny do pobrania pod adresem https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Dotyczy

Zobacz też