XpsDigSigPartAlteringRestrictions Enumeração

Referência

Definição

Namespace:: System.Windows.Xps.Packaging

Assembly:: ReachFramework.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Especifica as partes do Package XPS que são excluídas do intervalo de uma assinatura digital.

Essa enumeração dá suporte a uma combinação bit a bit dos valores de membro.

public enum class XpsDigSigPartAlteringRestrictions

[System.Flags]
public enum XpsDigSigPartAlteringRestrictions

[<System.Flags>]
type XpsDigSigPartAlteringRestrictions =

Public Enum XpsDigSigPartAlteringRestrictions

Herança: Object

ValueType

Enum
XpsDigSigPartAlteringRestrictions

Atributos: FlagsAttribute

Campos

Nome	Valor	Description
Annotations	2	A parte Anotações é excluída.
CoreMetadata	1	A parte Propriedades Principais é excluída.
None	0	Nenhuma parte é excluída.
SignatureOrigin	4	A parte Origem da Assinatura é excluída.

Exemplos

O exemplo a seguir mostra como usar essa enumeração para assinar digitalmente um 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

Comentários

Essa enumeração tem um FlagsAttribute que permite uma combinação bit a bit de seus valores de membro.

As partes especificadas como excluídas da assinatura digital podem ser modificadas sem invalidar a assinatura. Por exemplo, se um documento for assinado por mais de uma pessoa, a parte SignatureOrigin precisará ser excluída da assinatura quando o documento for assinado pela primeira vez. (As exclusões são especificadas no restrictions parâmetro da chamada para SignDigitally.) Se a parte SignatureOrigin não for excluída, quaisquer assinaturas adicionais invalidarão a assinatura do primeiro signatário.

Para obter mais informações sobre assinaturas digitais, confira Estrutura de Assinatura Digital das Convenções de Empacotamento Aberto.

Para obter mais informações sobre as partes Propriedades Principais e Origem da Assinatura, consulte o Capítulo 3 da especificação Convenções de Empacotamento Aberto disponível para download em https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Aplica-se a

Produto	Versões
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Partilhar via