X509Certificate2UI.SelectFromCollection Yöntem

Tanım

Ad Alanı:

System.Security.Cryptography.X509Certificates

Bütünleştirilmiş Kod:

System.Windows.Extensions.dll

Paket:

System.Windows.Extensions v9.0.0-preview.3.24172.9

Bir sertifika koleksiyonundan X.509 sertifikası seçmek için bir iletişim kutusu görüntüler.

Aşırı Yüklemeler

SelectFromCollection(X509Certificate2Collection, String, String, X509SelectionFlag)	Bir sertifika koleksiyonundan X.509 sertifikası seçmek için bir iletişim kutusu görüntüler.
SelectFromCollection(X509Certificate2Collection, String, String, X509SelectionFlag, IntPtr)	Bir üst pencere tutamacını kullanarak bir sertifika koleksiyonundan X.509 sertifikası seçmeye yönelik bir iletişim kutusu görüntüler.

Açıklamalar

Kullanıcıların bir iletişim kutusu kullanarak X.509 sertifikalarını el ile seçmesini istiyorsanız bu yöntemi kullanın. Kullanıcı etkileşimi gerekmiyorsa yöntemini kullanın X509Certificate2Collection.Find .

SelectFromCollection(X509Certificate2Collection, String, String, X509SelectionFlag)

Kaynak:

X509Certificate2UI.cs

Bir sertifika koleksiyonundan X.509 sertifikası seçmek için bir iletişim kutusu görüntüler.

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

Parametreler

certificates

X509Certificate2Collection

Arasından seçim yapmak için X.509 sertifikalarından oluşan bir koleksiyon.

title

String

İletişim kutusunun başlığı.

message

String

Kullanıcıya yol gösterecek açıklayıcı bir ileti. İleti iletişim kutusunda görüntülenir.

selectionFlag

X509SelectionFlag

Tek veya birden çok seçime X509SelectionFlag izin verilip verilmeyeceğini belirten değerlerden biri.

Döndürülenler

X509Certificate2Collection

X509Certificate2Collection Seçili sertifikayı veya sertifikaları içeren bir nesne.

Özel durumlar

ArgumentException

selectionFlag parametresi geçerli bir bayrak değil.

ArgumentNullException

certificates parametresidirnull.

CryptographicException

certificates Parametre geçersiz.

Örnekler

Aşağıdaki kod örneği, X.509 sertifikalarını seçmek ve görüntülemek için kullanıcı arabirimi iletişim kutularının nasıl görüntüleneceğini gösterir.

#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

Açıklamalar

SelectFromCollection Kullanıcıların bir iletişim kutusu kullanarak X.509 sertifikalarını el ile seçmesini istiyorsanız yöntemini kullanın. Kullanıcı etkileşimi gerekmiyorsa yöntemini kullanın X509Certificate2Collection.Find .

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

Kaynak:

X509Certificate2UI.cs

Bir üst pencere tutamacını kullanarak bir sertifika koleksiyonundan X.509 sertifikası seçmeye yönelik bir iletişim kutusu görüntüler.

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);

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

Parametreler

certificates

X509Certificate2Collection

Arasından seçim yapmak için X.509 sertifikalarından oluşan bir koleksiyon.

title

String

İletişim kutusunun başlığı.

message

String

Kullanıcıya yol gösterecek açıklayıcı bir ileti. İleti iletişim kutusunda görüntülenir.

selectionFlag

X509SelectionFlag

Tek veya birden çok seçime X509SelectionFlag izin verilip verilmeyeceğini belirten değerlerden biri.

hwndParent

IntPtr

nativeint

Görüntüleme iletişim kutusu için kullanılacak üst pencere tutamacı.

Döndürülenler

X509Certificate2Collection

X509Certificate2Collection Seçili sertifikayı veya sertifikaları içeren bir nesne.

Özel durumlar

ArgumentException

selectionFlag parametresi geçerli bir bayrak değil.

ArgumentNullException

certificates parametresidirnull.

CryptographicException

certificates Parametre geçersiz.

Açıklamalar

SelectFromCollection Kullanıcıların bir iletişim kutusu kullanarak X.509 sertifikalarını el ile seçmesini istiyorsanız yöntemini kullanın. Kullanıcı etkileşimi gerekmiyorsa yöntemini kullanın X509Certificate2Collection.Find .