Sprache

KeyChain.ChooseX509Certificate2WithPrivateKeyAsync Methode

Definition

Überlädt

Name Beschreibung
ChooseX509Certificate2WithPrivateKeyAsync(Activity, String[], IPrincipal[], Uri, String)

Zeigt die System-UI für den Benutzer an, um ein Zertifikat auszuwählen, und ruft dann den entsprechenden X509Certificate2 mit seinem privaten Schlüssel ab und filtert nach URI.

ChooseX509Certificate2WithPrivateKeyAsync(Activity, String[], IPrincipal[], String, Int32, String)

Zeigt die Systembenutzeroberfläche für den Benutzer an, um ein Zertifikat auszuwählen, und ruft dann den entsprechenden X509Certificate2 mit seinem privaten Schlüssel ab, filtert nach Host und Port.

ChooseX509Certificate2WithPrivateKeyAsync(Activity, String[], IPrincipal[], Uri, String)

Zeigt die System-UI für den Benutzer an, um ein Zertifikat auszuwählen, und ruft dann den entsprechenden X509Certificate2 mit seinem privaten Schlüssel ab und filtert nach URI.

public static System.Threading.Tasks.Task<System.Security.Cryptography.X509Certificates.X509Certificate2?> ChooseX509Certificate2WithPrivateKeyAsync(Android.App.Activity activity, string[]? keyTypes, Java.Security.IPrincipal[]? issuers, Android.Net.Uri? uri, string? alias);
static member ChooseX509Certificate2WithPrivateKeyAsync : Android.App.Activity * string[] * Java.Security.IPrincipal[] * Android.Net.Uri * string -> System.Threading.Tasks.Task<System.Security.Cryptography.X509Certificates.X509Certificate2>

Parameter

activity
Activity

Die Aktivität, die als übergeordnetes Element für die Zertifikatauswahl-UI verwendet werden soll.

keyTypes
String[]

Die zulässigen Typen von asymmetrischen Schlüsseln oder null die Zulässigkeit eines beliebigen Typs.

issuers
IPrincipal[]

Die zulässigen Zertifikatherausgeber für das Zertifikat, das dem privaten Schlüssel entspricht, oder null um einen Aussteller zuzulassen.

uri
Uri

Der URI, nach dem gefiltert werden soll, oder null um dem Benutzer die Auswahl eines alias zu ermöglichen.

alias
String

Der anfängliche Alias, der vorwählen soll, falls verfügbar oder null ohne Vorauswahl.

Gibt zurück

Eine Task<TResult>, die den asynchronen Vorgang darstellt. Das Ergebnis ist ein X509Certificate2 Enthalten des Zertifikats und des privaten Schlüssels, oder null wenn der Benutzer die Auswahl abgebrochen hat oder das Zertifikat nicht abgerufen werden konnte.

Hinweise

Diese Methode kombiniert ChoosePrivateKeyAliasAsync(Activity, String[], IPrincipal[], Uri, String) und GetX509Certificate2WithPrivateKey(Context, String) in einem einzigen Aufruf für einen einstufigen TLS-Clientzertifikatworkflow. Diese Überladung erfordert Android-API 23 oder höher.

Gilt für:

ChooseX509Certificate2WithPrivateKeyAsync(Activity, String[], IPrincipal[], String, Int32, String)

Zeigt die Systembenutzeroberfläche für den Benutzer an, um ein Zertifikat auszuwählen, und ruft dann den entsprechenden X509Certificate2 mit seinem privaten Schlüssel ab, filtert nach Host und Port.

public static System.Threading.Tasks.Task<System.Security.Cryptography.X509Certificates.X509Certificate2?> ChooseX509Certificate2WithPrivateKeyAsync(Android.App.Activity activity, string[]? keyTypes, Java.Security.IPrincipal[]? issuers, string? host, int port, string? alias);
static member ChooseX509Certificate2WithPrivateKeyAsync : Android.App.Activity * string[] * Java.Security.IPrincipal[] * string * int * string -> System.Threading.Tasks.Task<System.Security.Cryptography.X509Certificates.X509Certificate2>

Parameter

activity
Activity

Die Aktivität, die als übergeordnetes Element für die Zertifikatauswahl-UI verwendet werden soll.

keyTypes
String[]

Die zulässigen Typen von asymmetrischen Schlüsseln oder null die Zulässigkeit eines beliebigen Typs.

issuers
IPrincipal[]

Die zulässigen Zertifikatherausgeber für das Zertifikat, das dem privaten Schlüssel entspricht, oder null um einen Aussteller zuzulassen.

host
String

Der Hostname des Servers, der das Zertifikat anfordert, oder null für keine Hostfilterung.

port
Int32

Die Portnummer des Servers, der das Zertifikat anfordert oder -1 nicht verfügbar ist.

alias
String

Der anfängliche Alias, der vorwählen soll, falls verfügbar oder null ohne Vorauswahl.

Gibt zurück

Eine Task<TResult>, die den asynchronen Vorgang darstellt. Das Ergebnis ist ein X509Certificate2 Enthalten des Zertifikats und des privaten Schlüssels, oder null wenn der Benutzer die Auswahl abgebrochen hat oder das Zertifikat nicht abgerufen werden konnte.

Hinweise

Diese Methode kombiniert ChoosePrivateKeyAliasAsync(Activity, String[], IPrincipal[], String, Int32, String) und GetX509Certificate2WithPrivateKey(Context, String) in einem einzigen Aufruf für einen einstufigen TLS-Clientzertifikatworkflow.

Gilt für: