X500DistinguishedNameFlags Enumeração

Definição

Espaço de Nomes:
System.Security.Cryptography.X509Certificates
Assemblagens:
netstandard.dll, System.Security.Cryptography.dll
Assemblagens:
netstandard.dll, System.Security.Cryptography.X509Certificates.dll
Assemblagens:
netstandard.dll, System.Security.Cryptography.dll, System.Security.Cryptography.X509Certificates.dll
Assemblagem:
System.Security.Cryptography.X509Certificates.dll
Assemblagem:
System.dll
Assemblagem:
netstandard.dll
Origem:
X500DistinguishedNameFlags.cs
Origem:
X500DistinguishedNameFlags.cs
Origem:
X509CertificateLoader.Unix.cs

Especifica características do nome distinto X.500.

Esta enumeração suporta uma combinação bit-a-bit dos respetivos valores membro.

public enum class X500DistinguishedNameFlags
[System.Flags]
public enum X500DistinguishedNameFlags
[<System.Flags>]
type X500DistinguishedNameFlags = 
Public Enum X500DistinguishedNameFlags
Herança
Object
ValueType
Enum
X500DistinguishedNameFlags
Atributos
FlagsAttribute

Campos

Name Valor Description
None 0

O nome distinto não apresenta características especiais.
Reversed 1

O nome distinto está invertido.
UseSemicolons 16

O nome distinto utiliza ponto e vírgula.
DoNotUsePlusSign 32

O nome distinto não utiliza o sinal de mais.
DoNotUseQuotes 64

O nome distinto não utiliza aspas.
UseCommas 128

O nome distinto usa vírgulas.
UseNewLines 256

O nome distinto utiliza o novo carácter de linha.
UseUTF8Encoding 4096

O nome distinto utiliza codificação UTF8 em vez de codificação de caracteres Unicode.
UseT61Encoding 8192

O nome distinto utiliza a codificação T61.
ForceUTF8Encoding 16384

Força o nome distinto a codificar chaves X.500 específicas como cadeias UTF-8 em vez de cadeias Unicode imprimíveis. Para mais informações e a lista de chaves X.500 afetadas, consulte a enumeração X500NameFlags.

Exemplos

O seguinte exemplo de código mostra como usar a X500DistinguishedNameFlags enumeração.

using System;
using System.Security.Cryptography;
using System.Security.Cryptography.X509Certificates;

class X500Sample
{
    static void Main()
    {
        try
        {
            X509Store store = new("MY", StoreLocation.CurrentUser);
            store.Open(OpenFlags.ReadOnly | OpenFlags.OpenExistingOnly);
            X509Certificate2Collection collection = store.Certificates;
            X509Certificate2Collection fcollection = collection.Find(
                X509FindType.FindByTimeValid,
                DateTime.Now, false
                );
            X509Certificate2Collection scollection = X509Certificate2UI.SelectFromCollection(
                fcollection,
                "Test Certificate Select",
                "Select a certificate from the following list to get information on that certificate",
                X509SelectionFlag.MultiSelection
                );
            Console.WriteLine($"Number of certificates: {scollection.Count}{Environment.NewLine}");
            foreach (X509Certificate2 x509 in scollection)
            {
                X500DistinguishedName dname = new(
                    x509.SubjectName.Name,
                    X500DistinguishedNameFlags.Reversed | X500DistinguishedNameFlags.UseSemicolons
                    );
                Console.WriteLine("X500DistinguishedName: {0}{1}", dname.Name, Environment.NewLine);
                x509.Reset();
            }
            store.Close();
        }
        catch (CryptographicException)
        {
            Console.WriteLine("Information could not be written out for this certificate.");
        }
    }
}

Imports System.Security.Cryptography.X509Certificates

Class X500Sample
    Shared s_msg As String
    Shared Sub Main()

        Try
            Dim store As New X509Store("MY", StoreLocation.CurrentUser)
            store.Open(OpenFlags.ReadOnly Or OpenFlags.OpenExistingOnly)
            Dim collection As X509Certificate2Collection = store.Certificates
            Dim fcollection As X509Certificate2Collection = collection.Find(X509FindType.FindByTimeValid, Date.Now, False)
            Dim scollection As X509Certificate2Collection = X509Certificate2UI.SelectFromCollection(
                fcollection,
                "Test Certificate Select",
                "Select a certificate from the following list to get information on that certificate",
                X509SelectionFlag.MultiSelection
                )
            s_msg = "Number of certificates: " & scollection.Count & Environment.NewLine
            Console.WriteLine(s_msg)
            Dim x509 As X509Certificate2
            For Each x509 In scollection
                Dim dname As New X500DistinguishedName(
                x509.SubjectName.Name,
                X500DistinguishedNameFlags.Reversed Or X500DistinguishedNameFlags.UseSemicolons
                )
                s_msg = "X500DistinguishedName: " & dname.Name & Environment.NewLine
                Console.WriteLine(s_msg)
                x509.Reset()
            Next x509
            store.Close()
        Catch e As Exception
            s_msg = "Error: Information could not be written out for this certificate."
            Console.WriteLine(s_msg)
        End Try
    End Sub
End Class

Observações

Esta enumeração é usada com a X500DistinguishedName classe para indicar caracteres especiais contidos no nome distinto.

Vários valores são mutuamente exclusivos nesta enumeração; usar apenas um destes valores para definir as características especiais de um nome distinguido X.500. Por exemplo, especifique apenas um dos UseCommasvalores , UseNewLines , e UseSemicolons . Também deves especificar ou UseT61Encoding .UseUTF8Encoding

Aplica-se a