X500DistinguishedNameFlags Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
- 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.