X500DistinguishedNameFlags Enumeration
Specifies characteristics of the X.500 distinguished name.
This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.
Assembly: System (in System.dll)
| Member name | Description | |
|---|---|---|
| DoNotUsePlusSign | The distinguished name does not use the plus sign. | |
| DoNotUseQuotes | The distinguished name does not use quotation marks. | |
| ForceUTF8Encoding | Forces the distinguished name to encode specific X.500 keys as UTF-8 strings rather than printable Unicode strings. For more information and the list of X.500 keys affected, see the X500NameFlags enumeration. | |
| None | The distinguished name has no special characteristics. | |
| Reversed | The distinguished name is reversed. | |
| UseCommas | The distinguished name uses commas. | |
| UseNewLines | The distinguished name uses the new line character. | |
| UseSemicolons | The distinguished name uses semicolons. | |
| UseT61Encoding | The distinguished name uses T61 encoding. | |
| UseUTF8Encoding | The distinguished name uses UTF8 encoding instead of Unicode character encoding. |
This enumeration is used with the X500DistinguishedNameFlags class to indicate special characters contained in the distinguished name.
Several values are mutually exclusive in this enumeration; use only one of these values to define the special characteristics of an X.500 distinguished name. For example, specify only one of the UseCommas, UseNewLines , and UseSemicolons values. You would also specify either UseT61Encoding or UseUTF8Encoding .
The following code example shows how to use the X500DistinguishedNameFlags enumeration.
Imports System 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 'Main End Class 'X500Sample
Available since 2.0