X509Certificate2UI.SelectFromCollection Método

Definição

Exibe uma caixa de diálogo para selecionar um certificado X.509 de uma coleção de certificados.

Sobrecargas

Nome Description
SelectFromCollection(X509Certificate2Collection, String, String, X509SelectionFlag)

Exibe uma caixa de diálogo para selecionar um certificado X.509 de uma coleção de certificados.

SelectFromCollection(X509Certificate2Collection, String, String, X509SelectionFlag, IntPtr)

Exibe uma caixa de diálogo para selecionar um certificado X.509 de uma coleção de certificados usando um identificador para uma janela pai.

Comentários

Use esse método se você exigir que os usuários selecionem manualmente certificados X.509 usando uma caixa de diálogo. Se nenhuma interação do usuário for necessária, use o X509Certificate2Collection.Find método.

SelectFromCollection(X509Certificate2Collection, String, String, X509SelectionFlag)

Origem:
X509Certificate2UI.cs
Origem:
X509Certificate2UI.cs
Origem:
X509Certificate2UI.cs
Origem:
X509Certificate2UI.cs
Origem:
X509Certificate2UI.cs
Origem:
X509Certificate2UI.cs
Origem:
X509Certificate2UI.cs

Exibe uma caixa de diálogo para selecionar um certificado X.509 de uma coleção de certificados.

public:
 static System::Security::Cryptography::X509Certificates::X509Certificate2Collection ^ SelectFromCollection(System::Security::Cryptography::X509Certificates::X509Certificate2Collection ^ certificates, System::String ^ title, System::String ^ message, System::Security::Cryptography::X509Certificates::X509SelectionFlag selectionFlag);
public static System.Security.Cryptography.X509Certificates.X509Certificate2Collection SelectFromCollection(System.Security.Cryptography.X509Certificates.X509Certificate2Collection certificates, string? title, string? message, System.Security.Cryptography.X509Certificates.X509SelectionFlag selectionFlag);
public static System.Security.Cryptography.X509Certificates.X509Certificate2Collection SelectFromCollection(System.Security.Cryptography.X509Certificates.X509Certificate2Collection certificates, string title, string message, System.Security.Cryptography.X509Certificates.X509SelectionFlag selectionFlag);
static member SelectFromCollection : System.Security.Cryptography.X509Certificates.X509Certificate2Collection * string * string * System.Security.Cryptography.X509Certificates.X509SelectionFlag -> System.Security.Cryptography.X509Certificates.X509Certificate2Collection
Public Shared Function SelectFromCollection (certificates As X509Certificate2Collection, title As String, message As String, selectionFlag As X509SelectionFlag) As X509Certificate2Collection

Parâmetros

certificates
X509Certificate2Collection

Uma coleção de certificados X.509 para selecionar.

title
String

O título da caixa de diálogo.

message
String

Uma mensagem descritiva para orientar o usuário. A mensagem é exibida na caixa de diálogo.

selectionFlag
X509SelectionFlag

Um dos X509SelectionFlag valores que especifica se seleções simples ou múltiplas são permitidas.

Retornos

Um X509Certificate2Collection objeto que contém o certificado ou certificados selecionados.

Exceções

O selectionFlag parâmetro não é um sinalizador válido.

O certificates parâmetro é null.

O parâmetro certificates é inválido.

Exemplos

O exemplo de código a seguir demonstra como exibir diálogos de interface do usuário para selecionar e exibir certificados X.509.

using System;
using System.Security.Cryptography;
using System.Security.Permissions;
using System.IO;
using System.Security.Cryptography.X509Certificates;

class CertSelect
{
    static void Main()
    {
        X509Store store = new X509Store("MY",StoreLocation.CurrentUser);
        store.Open(OpenFlags.ReadOnly | OpenFlags.OpenExistingOnly);

        X509Certificate2Collection collection = (X509Certificate2Collection)store.Certificates;
        X509Certificate2Collection fcollection = (X509Certificate2Collection)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: {0}{1}",scollection.Count,Environment.NewLine);

        foreach (X509Certificate2 x509 in scollection)
        {
            try
            {
                byte[] rawdata = 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("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();
            }
            catch (CryptographicException)
            {
                Console.WriteLine("Information could not be written out for this certificate.");
            }
        }
        store.Close();
    }
}
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)
         
        For Each x509 As X509Certificate2 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("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()         
             Catch cExcept As CryptographicException
                 Console.WriteLine("Information could not be written out for this certificate.")
             End Try
        Next x509

        store.Close()
    End Sub
End Class

Comentários

Use o SelectFromCollection método se você exigir que os usuários selecionem manualmente certificados X.509 usando uma caixa de diálogo. Se nenhuma interação do usuário for necessária, use o X509Certificate2Collection.Find método.

Aplica-se a

SelectFromCollection(X509Certificate2Collection, String, String, X509SelectionFlag, IntPtr)

Origem:
X509Certificate2UI.cs
Origem:
X509Certificate2UI.cs
Origem:
X509Certificate2UI.cs
Origem:
X509Certificate2UI.cs
Origem:
X509Certificate2UI.cs
Origem:
X509Certificate2UI.cs
Origem:
X509Certificate2UI.cs

Exibe uma caixa de diálogo para selecionar um certificado X.509 de uma coleção de certificados usando um identificador para uma janela pai.

public:
 static System::Security::Cryptography::X509Certificates::X509Certificate2Collection ^ SelectFromCollection(System::Security::Cryptography::X509Certificates::X509Certificate2Collection ^ certificates, System::String ^ title, System::String ^ message, System::Security::Cryptography::X509Certificates::X509SelectionFlag selectionFlag, IntPtr hwndParent);
public static System.Security.Cryptography.X509Certificates.X509Certificate2Collection SelectFromCollection(System.Security.Cryptography.X509Certificates.X509Certificate2Collection certificates, string? title, string? message, System.Security.Cryptography.X509Certificates.X509SelectionFlag selectionFlag, IntPtr hwndParent);
public static System.Security.Cryptography.X509Certificates.X509Certificate2Collection SelectFromCollection(System.Security.Cryptography.X509Certificates.X509Certificate2Collection certificates, string title, string message, System.Security.Cryptography.X509Certificates.X509SelectionFlag selectionFlag, IntPtr hwndParent);
[System.Security.SecurityCritical]
public static System.Security.Cryptography.X509Certificates.X509Certificate2Collection SelectFromCollection(System.Security.Cryptography.X509Certificates.X509Certificate2Collection certificates, string title, string message, System.Security.Cryptography.X509Certificates.X509SelectionFlag selectionFlag, IntPtr hwndParent);
static member SelectFromCollection : System.Security.Cryptography.X509Certificates.X509Certificate2Collection * string * string * System.Security.Cryptography.X509Certificates.X509SelectionFlag * nativeint -> System.Security.Cryptography.X509Certificates.X509Certificate2Collection
[<System.Security.SecurityCritical>]
static member SelectFromCollection : System.Security.Cryptography.X509Certificates.X509Certificate2Collection * string * string * System.Security.Cryptography.X509Certificates.X509SelectionFlag * nativeint -> System.Security.Cryptography.X509Certificates.X509Certificate2Collection
Public Shared Function SelectFromCollection (certificates As X509Certificate2Collection, title As String, message As String, selectionFlag As X509SelectionFlag, hwndParent As IntPtr) As X509Certificate2Collection

Parâmetros

certificates
X509Certificate2Collection

Uma coleção de certificados X.509 para selecionar.

title
String

O título da caixa de diálogo.

message
String

Uma mensagem descritiva para orientar o usuário. A mensagem é exibida na caixa de diálogo.

selectionFlag
X509SelectionFlag

Um dos X509SelectionFlag valores que especifica se seleções simples ou múltiplas são permitidas.

hwndParent
IntPtr

nativeint

Um identificador para a janela pai a ser usada para a caixa de diálogo de exibição.

Retornos

Um X509Certificate2Collection objeto que contém o certificado ou certificados selecionados.

Atributos

Exceções

O selectionFlag parâmetro não é um sinalizador válido.

O certificates parâmetro é null.

O parâmetro certificates é inválido.

Comentários

Use o SelectFromCollection método se você exigir que os usuários selecionem manualmente certificados X.509 usando uma caixa de diálogo. Se nenhuma interação do usuário for necessária, use o X509Certificate2Collection.Find método.

Aplica-se a