X509Certificate2UI.SelectFromCollection Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Visualizza una finestra di dialogo per la selezione di un certificato X.509 da una raccolta di certificati.
Overload
| Nome | Descrizione |
|---|---|
| SelectFromCollection(X509Certificate2Collection, String, String, X509SelectionFlag) |
Visualizza una finestra di dialogo per la selezione di un certificato X.509 da una raccolta di certificati. |
| SelectFromCollection(X509Certificate2Collection, String, String, X509SelectionFlag, IntPtr) |
Visualizza una finestra di dialogo per la selezione di un certificato X.509 da una raccolta di certificati usando un handle per una finestra padre. |
Commenti
Usare questo metodo se si richiede agli utenti di selezionare manualmente i certificati X.509 usando una finestra di dialogo. Se non è necessaria alcuna interazione dell'utente, usare il X509Certificate2Collection.Find metodo .
SelectFromCollection(X509Certificate2Collection, String, String, X509SelectionFlag)
Visualizza una finestra di dialogo per la selezione di un certificato X.509 da una raccolta di certificati.
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);
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
Parametri
- certificates
- X509Certificate2Collection
Raccolta di certificati X.509 da selezionare.
- title
- String
Titolo della finestra di dialogo.
- message
- String
Messaggio descrittivo per guidare l'utente. Il messaggio viene visualizzato nella finestra di dialogo.
- selectionFlag
- X509SelectionFlag
Uno dei X509SelectionFlag valori che specifica se sono consentite selezioni singole o multiple.
Valori restituiti
Oggetto X509Certificate2Collection che contiene il certificato o i certificati selezionati.
Eccezioni
Il selectionFlag parametro non è un flag valido.
Il certificates parametro è null.
Il parametro certificates non è valido.
Esempio
Nell'esempio di codice seguente viene illustrato come visualizzare le finestre di dialogo dell'interfaccia utente per selezionare e visualizzare i certificati 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
Commenti
Usare il SelectFromCollection metodo se si richiede agli utenti di selezionare manualmente i certificati X.509 usando una finestra di dialogo. Se non è necessaria alcuna interazione dell'utente, usare il X509Certificate2Collection.Find metodo .
Si applica a
SelectFromCollection(X509Certificate2Collection, String, String, X509SelectionFlag, IntPtr)
Visualizza una finestra di dialogo per la selezione di un certificato X.509 da una raccolta di certificati usando un handle per una finestra padre.
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);
[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
Parametri
- certificates
- X509Certificate2Collection
Raccolta di certificati X.509 da selezionare.
- title
- String
Titolo della finestra di dialogo.
- message
- String
Messaggio descrittivo per guidare l'utente. Il messaggio viene visualizzato nella finestra di dialogo.
- selectionFlag
- X509SelectionFlag
Uno dei X509SelectionFlag valori che specifica se sono consentite selezioni singole o multiple.
- hwndParent
-
IntPtr
nativeint
Handle per la finestra padre da utilizzare per la finestra di dialogo di visualizzazione.
Valori restituiti
Oggetto X509Certificate2Collection che contiene il certificato o i certificati selezionati.
- Attributi
Eccezioni
Il selectionFlag parametro non è un flag valido.
Il certificates parametro è null.
Il parametro certificates non è valido.
Commenti
Usare il SelectFromCollection metodo se si richiede agli utenti di selezionare manualmente i certificati X.509 usando una finestra di dialogo. Se non è necessaria alcuna interazione dell'utente, usare il X509Certificate2Collection.Find metodo .