X509Certificate2UI.SelectFromCollection Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.