X500DistinguishedName X500DistinguishedName X500DistinguishedName X500DistinguishedName Class

Définition

Représente le nom unique d’un certificat X509.Represents the distinguished name of an X509 certificate. Cette classe ne peut pas être héritée.This class cannot be inherited.

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
X500DistinguishedNameX500DistinguishedNameX500DistinguishedNameX500DistinguishedName

Exemples

L'exemple de code suivant montre comment utiliser la classe X500DistinguishedName.The following code example shows how to use the X500DistinguishedName class.

#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 de SubjectName la IssuerName propriété ou, qui est le nom de la personne ou de l’entité à laquelle le certificat est émis.This class is like an extension to the SubjectName or IssuerName property, which is the name of the person or entity that the certificate is being issued to. X. 500 est une norme internationale pour les services d’annuaires distribués.X.500 is an international standard for distributed directory services. Le nom unique utilise le format suivant:The distinguished name uses the following format:

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

Les limites de longueur de champ suivantes s’appliquent:The following field length limits apply:

ChampField Limite de longueurLength Limit
CountryCodeCountryCode 2 caractères2 characters
DernièreOrganization Jusqu’à 64 caractèresUp to 64 characters
UnitéOrganizationUnit Jusqu’à 32 caractèresUp to 32 characters
CommonNameCommonName Jusqu’à 64 caractèresUp to 64 characters

Les consignes suivantes s'appliquent :The following guidelines apply:

  • Les valeurs de champ peuvent être en majuscules ou en minuscules.Field values can be uppercase or lowercase.

  • Les délimiteurs sont des marques de barre oblique (/) et doivent apparaître avant la première valeur et entre les valeurs suivantes.Delimiters are slash marks (/) and must appear before the first value and between subsequent values.

  • Les délimiteurs peuvent être suivis d’un espace.Delimiters can be followed by a space.

Voici un exemple de nom correctement mis en forme: [X500:/ C = US/O = Microsoft/OU = WGA/CN = TedSt]The following is an example of a correctly formatted name: [X500:/ C=US/ O=Microsoft/ OU=WGA/ CN=TedSt]

Constructeurs

X500DistinguishedName(AsnEncodedData) X500DistinguishedName(AsnEncodedData) X500DistinguishedName(AsnEncodedData) X500DistinguishedName(AsnEncodedData)

Initialise une nouvelle instance de la classe X500DistinguishedName à l'aide de l'objet AsnEncodedData spécifié.Initializes a new instance of the X500DistinguishedName class using the specified AsnEncodedData object.

X500DistinguishedName(Byte[]) X500DistinguishedName(Byte[]) X500DistinguishedName(Byte[]) X500DistinguishedName(Byte[])

Initialise une nouvelle instance de la classe X500DistinguishedName avec les informations du tableau d'octets spécifié.Initializes a new instance of the X500DistinguishedName class using information from the specified byte array.

X500DistinguishedName(String) X500DistinguishedName(String) X500DistinguishedName(String) X500DistinguishedName(String)

Initialise une nouvelle instance de la classe X500DistinguishedName à l'aide d'informations provenant de la chaîne spécifiée.Initializes a new instance of the X500DistinguishedName class using information from the specified string.

X500DistinguishedName(String, X500DistinguishedNameFlags) X500DistinguishedName(String, X500DistinguishedNameFlags) X500DistinguishedName(String, X500DistinguishedNameFlags) 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.Initializes a new instance of the X500DistinguishedName class using the specified string and X500DistinguishedNameFlags flag.

X500DistinguishedName(X500DistinguishedName) X500DistinguishedName(X500DistinguishedName) X500DistinguishedName(X500DistinguishedName) X500DistinguishedName(X500DistinguishedName)

Initialise une nouvelle instance de la classe X500DistinguishedName à l'aide de l'objet X500DistinguishedName spécifié.Initializes a new instance of the X500DistinguishedName class using the specified X500DistinguishedName object.

Propriétés

Name Name Name Name

Obtient le nom unique délimité par des virgules d'un certificat X500.Gets the comma-delimited distinguished name from an X500 certificate.

Oid Oid Oid Oid

Obtient ou définit la valeur Oid pour un objet AsnEncodedData.Gets or sets the Oid value for an AsnEncodedData object.

(Inherited from AsnEncodedData)
RawData RawData RawData RawData

Obtient ou définit les données encodées ASN.1 (Abstract Syntax Notation One) représentées dans un tableau d'octets.Gets or sets the Abstract Syntax Notation One (ASN.1)-encoded data represented in a byte array.

(Inherited from AsnEncodedData)

Méthodes

CopyFrom(AsnEncodedData) CopyFrom(AsnEncodedData) CopyFrom(AsnEncodedData) CopyFrom(AsnEncodedData)

Copie les informations d'un objet AsnEncodedData.Copies information from an AsnEncodedData object.

(Inherited from AsnEncodedData)
Decode(X500DistinguishedNameFlags) Decode(X500DistinguishedNameFlags) Decode(X500DistinguishedNameFlags) Decode(X500DistinguishedNameFlags)

Décode un nom unique à l'aide des caractéristiques spécifiées par le paramètre flag.Decodes a distinguished name using the characteristics specified by the flag parameter.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Format(Boolean) Format(Boolean) Format(Boolean) 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.Returns a formatted version of an X500 distinguished name for printing or for output to a text window or to a console.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

S’applique à