X500DistinguishedNameFlags Enumeration

Definition

Gibt die Merkmale des X.500-Distinguished-Namens an.

Diese Enumeration unterstützt eine bitweise Kombination ihrer Memberwerte.

public enum class X500DistinguishedNameFlags
[System.Flags]
public enum X500DistinguishedNameFlags
[<System.Flags>]
type X500DistinguishedNameFlags = 
Public Enum X500DistinguishedNameFlags
Vererbung
X500DistinguishedNameFlags
Attribute

Felder

Name Wert Beschreibung
None 0

Der distinguishierte Name weist keine besonderen Merkmale auf.

Reversed 1

Der distinguished name is reversed.

UseSemicolons 16

Der distinguishierte Name verwendet Semikolons.

DoNotUsePlusSign 32

Der Distinguished Name verwendet nicht das Pluszeichen.

DoNotUseQuotes 64

Der Distinguished Name verwendet keine Anführungszeichen.

UseCommas 128

Der Distinguished Name verwendet Kommas.

UseNewLines 256

Der Distinguished Name verwendet das neue Zeilenzeichen.

UseUTF8Encoding 4096

Der distinguished Name verwendet UTF8-Codierung anstelle der Unicode-Zeichencodierung.

UseT61Encoding 8192

Der distinguished Name verwendet die T61-Codierung.

ForceUTF8Encoding 16384

Erzwingt den distinguished-Namen, bestimmte X.500-Schlüssel als UTF-8-Zeichenfolgen zu codieren und nicht als druckbare Unicode-Zeichenfolgen. Weitere Informationen und die Liste der betroffenen X.500-Schlüssel finden Sie in der X500NameFlags-Aufzählung.

Beispiele

Das folgende Codebeispiel zeigt, wie die X500DistinguishedNameFlags Enumeration verwendet wird.

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

Hinweise

Diese Aufzählung wird mit der X500DistinguishedName Klasse verwendet, um Sonderzeichen anzugeben, die im distinguishierten Namen enthalten sind.

In dieser Enumeration schließen sich mehrere Werte gegenseitig aus; Verwenden Sie nur einen dieser Werte, um die speziellen Merkmale eines X.500-Distinguished-Namens zu definieren. Geben Sie z. B. nur einen der Werte UseNewLines und UseSemicolons Werte anUseCommas. Sie würden auch entweder UseT61Encoding oder UseUTF8Encoding.

Gilt für: