X500DistinguishedNameFlags Enumeración

Definición

Espacio de nombres:

System.Security.Cryptography.X509Certificates

Ensamblado:

System.Security.Cryptography.dll

Especifica las características del nombre distintivo X.500.

Esta enumeración admite una combinación bit a bit de sus valores de miembro.

public enum class X500DistinguishedNameFlags

[System.Flags]
public enum X500DistinguishedNameFlags

[<System.Flags>]
type X500DistinguishedNameFlags = 

Public Enum X500DistinguishedNameFlags

Herencia

Object

ValueType

Enum

X500DistinguishedNameFlags

Atributos

FlagsAttribute

Campos

DoNotUsePlusSign	32	El nombre distintivo no utiliza el signo más.
DoNotUseQuotes	64	El nombre distintivo no utiliza comillas.
ForceUTF8Encoding	16384	Fuerza el nombre distintivo para que codifique las teclas específicas X.500 como cadenas UTF-8, en lugar de cadenas Unicode imprimibles. Para obtener más información y la lista de teclas X.500 afectadas, vea la Enumeración de X500NameFlags.
None	0	El nombre distintivo no tiene ninguna característica especial.
Reversed	1	El nombre distintivo está invertido.
UseCommas	128	El nombre distintivo utiliza comas.
UseNewLines	256	El nombre distintivo utiliza el carácter de nueva línea.
UseSemicolons	16	El nombre distintivo utiliza signos de punto y coma.
UseT61Encoding	8192	El nombre distintivo utiliza la codificación T61.
UseUTF8Encoding	4096	El nombre distintivo utiliza la codificación UTF8 en lugar de la codificación de caracteres Unicode.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la X500DistinguishedNameFlags enumeración .

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

Comentarios

Esta enumeración se usa con la X500DistinguishedName clase para indicar caracteres especiales contenidos en el nombre distintivo.

Varios valores son mutuamente excluyentes en esta enumeración; use solo uno de estos valores para definir las características especiales de un nombre distintivo X.500. Por ejemplo, especifique solo uno de los UseCommasvalores , UseNewLines y UseSemicolons . También especificaría UseT61Encoding o UseUTF8Encoding.