X500DistinguishedNameFlags Enumeración

Definición

Espacio de nombres:

System.Security.Cryptography.X509Certificates

Ensamblado:

System.Security.Cryptography.X509Certificates.dll

Ensamblado:

System.Security.Cryptography.dll

Ensamblado:

System.dll

Ensamblado:

netstandard.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.dll>
#using <system.security.dll>

using namespace System;
using namespace System::Security::Cryptography;
using namespace System::Security::Permissions;
using namespace System::IO;
using namespace System::Security::Cryptography::X509Certificates;
int main()
{
   try
   {
      X509Store ^ store = gcnew X509Store( "MY",StoreLocation::CurrentUser );
      store->Open( static_cast<OpenFlags>(OpenFlags::ReadOnly | OpenFlags::OpenExistingOnly) );
      X509Certificate2Collection ^ collection = dynamic_cast<X509Certificate2Collection^>(store->Certificates);
      X509Certificate2Collection ^ fcollection = dynamic_cast<X509Certificate2Collection^>(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: {0}{1}", scollection->Count, Environment::NewLine );
      System::Collections::IEnumerator^ myEnum = scollection->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         X509Certificate2 ^ x509 = safe_cast<X509Certificate2 ^>(myEnum->Current);
         X500DistinguishedName ^ dname = gcnew X500DistinguishedName( x509->SubjectName );
         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." );
   }

}

using System;
using System.Security.Cryptography;
using System.Security.Permissions;
using System.IO;
using System.Security.Cryptography.X509Certificates;

class X500Sample
{
    static void Main()
    {
        try
        {
            X509Store store = new X509Store("MY", StoreLocation.CurrentUser);
            store.Open(OpenFlags.ReadOnly | OpenFlags.OpenExistingOnly);
            X509Certificate2Collection collection = (X509Certificate2Collection)store.Certificates;
            X509Certificate2Collection fcollection = (X509Certificate2Collection)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: {0}{1}", scollection.Count, Environment.NewLine);
            foreach (X509Certificate2 x509 in scollection)
            {
                X500DistinguishedName dname = new X500DistinguishedName(x509.SubjectName);
                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
Imports System.Security.Permissions
Imports System.IO
Imports System.Security.Cryptography.X509Certificates



Class X500Sample
   Shared 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 = CType(store.Certificates, X509Certificate2Collection)
         Dim fcollection As X509Certificate2Collection = CType(collection.Find(X509FindType.FindByTimeValid, DateTime.Now, False), X509Certificate2Collection)
         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)
     msg = "Number of certificates: " & scollection.Count & Environment.NewLine
     MsgBox(msg)
         Dim x509 As X509Certificate2
         For Each x509 In  scollection
            Dim dname As New X500DistinguishedName(x509.SubjectName)
        msg = "X500DistinguishedName: " & dname.Name & Environment.NewLine
     MsgBox(msg)
            x509.Reset()
         Next x509
         store.Close()
     Catch e As Exception
            msg = "Error: Information could not be written out for this certificate."
            MsgBox(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 o UseT61Encoding UseUTF8Encoding.