X509Certificate2UI.SelectFromCollection Метод

Определение

Пространство имен:: System.Security.Cryptography.X509Certificates

Сборка:: System.Windows.Extensions.dll

Сборка:: System.Security.dll

Отображает диалоговое окно для выбора сертификата X.509 из коллекции сертификатов.Displays a dialog box for selecting an X.509 certificate from a certificate collection.

Перегрузки

SelectFromCollection(X509Certificate2Collection, String, String, X509SelectionFlag)	Отображает диалоговое окно для выбора сертификата X.509 из коллекции сертификатов.Displays a dialog box for selecting an X.509 certificate from a certificate collection.
SelectFromCollection(X509Certificate2Collection, String, String, X509SelectionFlag, IntPtr)	Отображает диалоговое окно для выбора сертификата X.509 из коллекции сертификатов с помощью дескриптора родительского окна.Displays a dialog box for selecting an X.509 certificate from a certificate collection using a handle to a parent window.

Используйте этот метод, если требуется, чтобы пользователи вручную выбрали сертификаты X. 509 с помощью диалогового окна.Use this method if you require users to manually select X.509 certificates using a dialog box. Если вмешательство пользователя не требуется, используйте X509Certificate2Collection.Find метод.If no user interaction is required, use the X509Certificate2Collection.Find method.

SelectFromCollection(X509Certificate2Collection, String, String, X509SelectionFlag)

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

Параметры

certificates: X509Certificate2Collection

Коллекция сертификатов X.509, из которых производится выбор.A collection of X.509 certificates to select from.

title: String

Название диалогового окна.The title of the dialog box.

message: String

Сообщение с описанием для помощи пользователю.A descriptive message to guide the user. Сообщение отображается в диалоговом окне.The message is displayed in the dialog box.

selectionFlag: X509SelectionFlag

Одно из значений X509SelectionFlag, определяющее, будет ли разрешен выбор одного или нескольких сертификатов.One of the X509SelectionFlag values that specifies whether single or multiple selections are allowed.

Возвращаемое значение

X509Certificate2Collection

Объект X509Certificate2Collection, который содержит выбранный сертификат или выбранные сертификаты.An X509Certificate2Collection object that contains the selected certificate or certificates.

Исключения

ArgumentException

Параметр selectionFlag не является допустимым флагом.The selectionFlag parameter is not a valid flag.

ArgumentNullException

Параметр certificates имеет значение null.The certificates parameter is null.

CryptographicException

Параметр certificates является недопустимым.The certificates parameter is invalid.

Примеры

В следующем примере кода показано, как отобразить диалоговые окна пользовательского интерфейса для выбора и просмотра сертификатов X. 509.The following code example demonstrates how to display user interface dialogs to select and view X.509 certificates.

#using <System.dll>
#using <System.Security.dll>

using namespace System;
using namespace System::Security::Cryptography;
using namespace System::Security::Permissions;
using namespace System::IO;
using namespace System::Security::Cryptography::X509Certificates;
int main()
{
   try
   {
      X509Store ^ store = gcnew X509Store( "MY",StoreLocation::CurrentUser );
      store->Open( static_cast<OpenFlags>(OpenFlags::ReadOnly | OpenFlags::OpenExistingOnly) );
      X509Certificate2Collection ^ collection = dynamic_cast<X509Certificate2Collection^>(store->Certificates);
      X509Certificate2Collection ^ fcollection = dynamic_cast<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 );
      System::Collections::IEnumerator^ myEnum = scollection->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         X509Certificate2 ^ x509 = safe_cast<X509Certificate2 ^>(myEnum->Current);
         array<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( "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 );
         x509->Reset();
      }
      store->Close();
   }
   catch ( CryptographicException^ ) 
   {
      Console::WriteLine( "Information could not be written out for this certificate." );
   }

}

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

Используйте SelectFromCollection метод, если требуется, чтобы пользователи вручную выбрали сертификаты X. 509 с помощью диалогового окна.Use the SelectFromCollection method if you require users to manually select X.509 certificates using a dialog box. Если вмешательство пользователя не требуется, используйте X509Certificate2Collection.Find метод.If no user interaction is required, use the X509Certificate2Collection.Find method.

Применяется к

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

Отображает диалоговое окно для выбора сертификата X.509 из коллекции сертификатов с помощью дескриптора родительского окна.Displays a dialog box for selecting an X.509 certificate from a certificate collection using a handle to a parent window.

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

Параметры

certificates: X509Certificate2Collection

Коллекция сертификатов X.509, из которых производится выбор.A collection of X.509 certificates to select from.

title: String

Название диалогового окна.The title of the dialog box.

message: String

selectionFlag: X509SelectionFlag

hwndParent: IntPtr

Дескриптор родительского окна, используемый для диалогового окна отображения.A handle to the parent window to use for the display dialog box.

Возвращаемое значение

X509Certificate2Collection

Атрибуты: SecurityCriticalAttribute

Исключения

ArgumentException

Параметр selectionFlag не является допустимым флагом.The selectionFlag parameter is not a valid flag.

ArgumentNullException

Параметр certificates имеет значение null.The certificates parameter is null.

CryptographicException

Параметр certificates является недопустимым.The certificates parameter is invalid.

Применяется к

X509Certificate2UI.SelectFromCollection Метод

Определение

Перегрузки

Комментарии

SelectFromCollection(X509Certificate2Collection, String, String, X509SelectionFlag)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

Применяется к

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

Параметры

Возвращаемое значение

Исключения

Комментарии

Применяется к

Были ли сведения на этой странице полезными?

Были ли сведения на этой странице полезными?