X509Certificate2UI.SelectFromCollection Methode

Definitie

Naamruimte:: System.Security.Cryptography.X509Certificates

Assembly:: System.Windows.Extensions.dll

Assembly:: System.Security.dll

Pakket:: System.Windows.Extensions v11.0.0-preview.4.26230.115

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee wordt een dialoogvenster weergegeven voor het selecteren van een X.509-certificaat uit een certificaatverzameling.

Overloads

Name	Description
SelectFromCollection(X509Certificate2Collection, String, String, X509SelectionFlag)	Hiermee wordt een dialoogvenster weergegeven voor het selecteren van een X.509-certificaat uit een certificaatverzameling.
SelectFromCollection(X509Certificate2Collection, String, String, X509SelectionFlag, IntPtr)	Hiermee wordt een dialoogvenster weergegeven voor het selecteren van een X.509-certificaat uit een certificaatverzameling met behulp van een ingang naar een bovenliggend venster.

Opmerkingen

Gebruik deze methode als u wilt dat gebruikers X.509-certificaten handmatig selecteren met behulp van een dialoogvenster. Als er geen gebruikersinteractie is vereist, gebruikt u de X509Certificate2Collection.Find methode.

SelectFromCollection(X509Certificate2Collection, String, String, X509SelectionFlag)

Bron:: X509Certificate2UI.cs

Bron:: X509Certificate2UI.cs

Bron:: X509Certificate2UI.cs

Bron:: X509Certificate2UI.cs

Bron:: X509Certificate2UI.cs

Bron:: X509Certificate2UI.cs

Bron:: X509Certificate2UI.cs

Hiermee wordt een dialoogvenster weergegeven voor het selecteren van een X.509-certificaat uit een certificaatverzameling.

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

Parameters

certificates: X509Certificate2Collection

Een verzameling X.509-certificaten waaruit u kunt kiezen.

title: String

De titel van het dialoogvenster.

message: String

Een beschrijvend bericht om de gebruiker te begeleiden. Het bericht wordt weergegeven in het dialoogvenster.

selectionFlag: X509SelectionFlag

Een van de X509SelectionFlag waarden die aangeeft of een of meer selecties zijn toegestaan.

Retouren

X509Certificate2Collection

Een X509Certificate2Collection object dat het geselecteerde certificaat of de geselecteerde certificaten bevat.

Uitzonderingen

ArgumentException

De selectionFlag parameter is geen geldige vlag.

ArgumentNullException

De certificates parameter is null.

CryptographicException

De certificates parameter is ongeldig.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u dialoogvensters van de gebruikersinterface kunt weergeven om X.509-certificaten te selecteren en weer te geven.

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

Opmerkingen

Gebruik de SelectFromCollection methode als u wilt dat gebruikers X.509-certificaten handmatig selecteren met behulp van een dialoogvenster. Als er geen gebruikersinteractie is vereist, gebruikt u de X509Certificate2Collection.Find methode.

Van toepassing op

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

Bron:: X509Certificate2UI.cs

Bron:: X509Certificate2UI.cs

Bron:: X509Certificate2UI.cs

Bron:: X509Certificate2UI.cs

Bron:: X509Certificate2UI.cs

Bron:: X509Certificate2UI.cs

Bron:: X509Certificate2UI.cs

Hiermee wordt een dialoogvenster weergegeven voor het selecteren van een X.509-certificaat uit een certificaatverzameling met behulp van een ingang naar een bovenliggend venster.

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

Parameters

certificates: X509Certificate2Collection

Een verzameling X.509-certificaten waaruit u kunt kiezen.

title: String

De titel van het dialoogvenster.

message: String

Een beschrijvend bericht om de gebruiker te begeleiden. Het bericht wordt weergegeven in het dialoogvenster.

selectionFlag: X509SelectionFlag

Een van de X509SelectionFlag waarden die aangeeft of een of meer selecties zijn toegestaan.

hwndParent: IntPtr
nativeint

Een ingang naar het bovenliggende venster dat moet worden gebruikt voor het weergavedialoogvenster.

Retouren

X509Certificate2Collection

Een X509Certificate2Collection object dat het geselecteerde certificaat of de geselecteerde certificaten bevat.

Kenmerken: SecurityCriticalAttribute

Uitzonderingen

ArgumentException

De selectionFlag parameter is geen geldige vlag.

ArgumentNullException

De certificates parameter is null.

CryptographicException

De certificates parameter is ongeldig.

Opmerkingen

Van toepassing op

Feedback

Is deze pagina nuttig?