KeyChain.ChooseX509Certificate2WithPrivateKeyAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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.