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
| Nombre | Valor | Description |
|---|---|---|
| None | 0 | El nombre distintivo no tiene características especiales. |
| Reversed | 1 | Se invierte el nombre distintivo. |
| UseSemicolons | 16 | El nombre distintivo usa punto y coma. |
| DoNotUsePlusSign | 32 | El nombre distintivo no usa el signo más. |
| DoNotUseQuotes | 64 | El nombre distintivo no usa comillas. |
| UseCommas | 128 | El nombre distintivo usa comas. |
| UseNewLines | 256 | El nombre distintivo usa el nuevo carácter de línea. |
| UseUTF8Encoding | 4096 | El nombre distintivo usa codificación UTF8 en lugar de codificación de caracteres Unicode. |
| UseT61Encoding | 8192 | El nombre distintivo usa la codificación T61. |
| ForceUTF8Encoding | 16384 | Obliga al nombre distintivo a codificar claves X.500 específicas como cadenas UTF-8 en lugar de cadenas Unicode imprimibles. Para obtener más información y la lista de claves X.500 afectadas, vea la enumeración X500NameFlags. |
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 incluidos 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.
