X509Certificate2Collection.Find Method
Searches an X509Certificate2Collection object using the search criteria specified by the X509FindType enumeration and the findValue object.
Assembly: System (in System.dll)
'Declaration Public Function Find ( _ findType As X509FindType, _ findValue As Object, _ validOnly As Boolean _ ) As X509Certificate2Collection
Parameters
- findType
- Type: System.Security.Cryptography.X509Certificates.X509FindType
One of the X509FindType values.
- findValue
- Type: System.Object
The search criteria as an object.
- validOnly
- Type: System.Boolean
true to allow only valid certificates to be returned from the search; otherwise, false.
Return Value
Type: System.Security.Cryptography.X509Certificates.X509Certificate2CollectionAn X509Certificate2Collection object.
| Exception | Condition |
|---|---|
| CryptographicException | findType is invalid. |
Use this method to find X509Certificate2 objects if no user interaction is needed. Use the Find method to allow the user to select X509Certificate2 objects.
Note that this method can be used in a cascading or nested style, narrowing the search criteria with each call to the method.
The following code example opens the current user's personal certificate store, finds only valid certificates, allows the user to select a certificate, and then writes certificate and certificate chain information to the console. The output depends on the certificate the user selects.
Imports System Imports System.Security.Cryptography Imports System.Security.Permissions Imports System.IO Imports System.Security.Cryptography.X509Certificates Class CertSelect Shared Sub Main() 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) Console.WriteLine("Number of certificates: {0}{1}", scollection.Count, Environment.NewLine) Dim x509 As X509Certificate2 For Each x509 In scollection Try Dim rawdata As Byte() = x509.RawData Console.WriteLine("Content Type: {0}{1}", X509Certificate2.GetCertContentType(rawdata), Environment.NewLine) Console.WriteLine("Friendly Name: {0}{1}", x509.FriendlyName, Environment.NewLine) Console.WriteLine("Certificate Verified?: {0}{1}", x509.Verify(), Environment.NewLine) Console.WriteLine("Simple Name: {0}{1}", x509.GetNameInfo(X509NameType.SimpleName, True), Environment.NewLine) Console.WriteLine("Signature Algorithm: {0}{1}", x509.SignatureAlgorithm.FriendlyName, Environment.NewLine) Console.WriteLine("Private Key: {0}{1}", x509.PrivateKey.ToXmlString(False), Environment.NewLine) Console.WriteLine("Public Key: {0}{1}", x509.PublicKey.Key.ToXmlString(False), Environment.NewLine) Console.WriteLine("Certificate Archived?: {0}{1}", x509.Archived, Environment.NewLine) Console.WriteLine("Length of Raw Data: {0}{1}", x509.RawData.Length, Environment.NewLine) X509Certificate2UI.DisplayCertificate(x509) x509.Reset() End Try Catch cExcept As CryptographicException Console.WriteLine("Information could not be written out for this certificate.") Next x509 store.Close() End Sub End Class
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.