XpsDigSigPartAlteringRestrictions Enumeração
Definição
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
- Atributos
Campos
| 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/.
