X500DistinguishedName Classe

Référence

Définition

Espace de noms:: System.Security.Cryptography.X509Certificates

Assembly:: System.Security.Cryptography.X509Certificates.dll

Assembly:: System.Security.Cryptography.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente le nom unique d’un certificat X509. Cette classe ne peut pas être héritée.

public ref class X500DistinguishedName sealed : System::Security::Cryptography::AsnEncodedData

public sealed class X500DistinguishedName : System.Security.Cryptography.AsnEncodedData

type X500DistinguishedName = class
    inherit AsnEncodedData

Public NotInheritable Class X500DistinguishedName
Inherits AsnEncodedData

Héritage: Object

AsnEncodedData
X500DistinguishedName

Exemples

L'exemple de code suivant montre comment utiliser la classe X500DistinguishedName.

#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

Remarques

Cette classe est semblable à une extension à la ou IssuerName à la SubjectName propriété, qui est le nom de la personne ou de l’entité à laquelle le certificat est émis. X.500 est une norme internationale pour les services d’annuaire distribués. Le nom unique utilise le format suivant :

[X500:/C=CountryCode/O=Organization/OU=OrganizationUnit/CN=CommonName]

Les limites de longueur de champ suivantes s’appliquent :

Champ	Limite de longueur
CountryCode	2 caractères
Organisation	Jusqu’à 64 caractères
OrganizationUnit	Jusqu’à 32 caractères
CommonName	Jusqu’à 64 caractères

Les consignes suivantes s'appliquent :

Les valeurs de champ peuvent être en majuscules ou en minuscules.
Les délimiteurs sont des barres obliques (/) et doivent apparaître avant la première valeur et entre les valeurs suivantes.
Les délimiteurs peuvent être suivis d’un espace.

Voici un exemple de nom correctement mis en forme : [X500:/ C=US/ O=Microsoft/ OU=WGA/ CN=TedSt]

Constructeurs

X500DistinguishedName(AsnEncodedData)	Initialise une nouvelle instance de la classe X500DistinguishedName à l'aide de l'objet AsnEncodedData spécifié.
X500DistinguishedName(Byte[])	Initialise une nouvelle instance de la classe X500DistinguishedName avec les informations du tableau d'octets spécifié.
X500DistinguishedName(ReadOnlySpan<Byte>)	Initialise une nouvelle instance de la classe X500DistinguishedName à l'aide d'informations provenant des données fournies.
X500DistinguishedName(String)	Initialise une nouvelle instance de la classe X500DistinguishedName à l'aide d'informations provenant de la chaîne spécifiée.
X500DistinguishedName(String, X500DistinguishedNameFlags)	Initialise une nouvelle instance de la classe X500DistinguishedName à l'aide de la chaîne et de l'indicateur X500DistinguishedNameFlags spécifiés.
X500DistinguishedName(X500DistinguishedName)	Initialise une nouvelle instance de la classe X500DistinguishedName à l'aide de l'objet X500DistinguishedName spécifié.

Propriétés

Name	Obtient le nom unique délimité par des virgules d'un certificat X500.
Oid	Obtient ou définit la valeur Oid pour un objet AsnEncodedData. (Hérité de AsnEncodedData)
RawData	Obtient ou définit les données encodées ASN.1 (Abstract Syntax Notation One) représentées dans un tableau d'octets. (Hérité de AsnEncodedData)

Méthodes

CopyFrom(AsnEncodedData)	Copie les informations d'un objet AsnEncodedData. (Hérité de AsnEncodedData)
Decode(X500DistinguishedNameFlags)	Décode un nom unique à l'aide des caractéristiques spécifiées par le paramètre `flag`.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
Format(Boolean)	Retourne une version mise en forme d'un nom unique X500 pour impression ou sortie dans une fenêtre de texte ou une console.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

S’applique à