XpsDigSigPartAlteringRestrictions Перечисление

Определение

Задает части Package XPS, исключенные из диапазона цифровой подписи.Specifies the parts of the XPS Package that are excluded from the range of a digital signature.

Это перечисление имеет атрибут FlagsAttribute, который разрешает побитовое сочетание значений его элементов.

public enum class XpsDigSigPartAlteringRestrictions
[System.Flags]
public enum XpsDigSigPartAlteringRestrictions
[<System.Flags>]
type XpsDigSigPartAlteringRestrictions = 
Public Enum XpsDigSigPartAlteringRestrictions
Наследование
XpsDigSigPartAlteringRestrictions
Атрибуты

Поля

Annotations 2

Часть "Annotations" исключена.The Annotations part is excluded.

CoreMetadata 1

Часть "Core Properties" исключена.The Core Properties part is excluded.

None 0

Ни одна часть не исключена.No parts are excluded.

SignatureOrigin 4

Часть "Signature Origin" исключена.The Signature Origin part is excluded.

Примеры

В следующем примере показано, как использовать это перечисление для цифровой подписи документа XPS.The following example shows how to use this enumeration to digitally sign an XPS document.


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

Комментарии

Это перечисление имеет атрибут FlagsAttribute, позволяющий побитовое сочетание значений его членов.This enumeration has a FlagsAttribute that allows a bitwise combination of its member values.

Части, указанные как исключенные из цифровой подписи, можно изменить без недействительности подписи.Parts that are specified as excluded from the digital signature can be modified without invalidating the signature. Например, если документ должен быть подписан более чем одним человеком, часть Сигнатуреоригин должна быть исключена из подписи при первой подписи документа.For example, if a document is to be signed by more than one person, the SignatureOrigin part needs to be excluded from the signature when the document is first signed. (Исключения указываются в restrictions параметре вызова SignDigitally .) Если часть Сигнатуреоригин не исключена, все дополнительные подписи сделают подпись первого знака недействительной.(Exclusions are specified in the restrictions parameter of the call to SignDigitally.) If the SignatureOrigin part is not excluded, any additional signatures invalidate the signature of the first signer.

Дополнительные сведения о цифровых подписях см. в статье MSDN платформа цифровой подписи статей с соглашениями Open Packaging , доступных по адресу https://go.microsoft.com/fwlink/?LinkId=74494 .For more information about digital signatures, see the MSDN article Digital Signing Framework of the Open Packaging Conventions available at https://go.microsoft.com/fwlink/?LinkId=74494.

Дополнительные сведения о базовых свойствах и частях источника подписи см. в главе 3 спецификации Open Packaging Conventions , доступной для загрузки по адресу https://go.microsoft.com/fwlink/?LinkID=71255 .For more information on the Core Properties and Signature Origin parts, see Chapter 3 of the Open Packaging Conventions specification available for download at https://go.microsoft.com/fwlink/?LinkID=71255.

Применяется к

См. также раздел