X509SelectionFlag Enumeration


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Specifies the type of selection requested using the X509Certificate2UI.SelectFromCollection method.

Namespace:   System.Security.Cryptography.X509Certificates
Assembly:  System.Security (in System.Security.dll)

public enum X509SelectionFlag

Member nameDescription

A multiple selection. The user can use the SHIFT or CRTL keys to select more than one X.509 certificate.


A single selection. The UI allows the user to select one X.509 certificate.

This flag represents either a single or multiple certificate selection using the X509Certificate2UI.SelectFromCollection method.

The following code example demonstrates how to use the selection flag with the X509Certificate2UI.SelectFromCollection method. This code example is part of a larger example provided for the X509Store class. The larger example opens the current user's personal certificate store, allows the user to select a certificate, then writes certificate and certificate chain information to the console. The output depends on the certificate the user selects.

//Create new X509 store from local certificate store.
X509Store store = new X509Store("MY", StoreLocation.CurrentUser);
store.Open(OpenFlags.OpenExistingOnly | OpenFlags.ReadWrite);

//Output store information.
Console.WriteLine ("Store Information");
Console.WriteLine ("Number of certificates in the store: {0}", store.Certificates.Count);
Console.WriteLine ("Store location: {0}", store.Location);
Console.WriteLine ("Store name: {0} {1}", store.Name, Environment.NewLine);

//Put certificates from the store into a collection so user can select one.
X509Certificate2Collection fcollection = (X509Certificate2Collection)store.Certificates;
X509Certificate2Collection collection = X509Certificate2UI.SelectFromCollection(fcollection, "Select an X509 Certificate", "Choose a certificate to examine.", X509SelectionFlag.SingleSelection);
X509Certificate2 certificate = collection[0];

.NET Framework
Available since 2.0
Return to top