X500DistinguishedNameFlags Enumeración
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- Atributos
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.
