HttpListenerRequest.GetClientCertificateAsync 方法

定義

命名空間:

System.Net

組件:

System.Net.HttpListener.dll

來源:

HttpListenerRequest.cs

以非同步作業的方式，擷取用戶端的 X.509 v.3 憑證。

public:
 System::Threading::Tasks::Task<System::Security::Cryptography::X509Certificates::X509Certificate2 ^> ^ GetClientCertificateAsync();

public System.Threading.Tasks.Task<System.Security.Cryptography.X509Certificates.X509Certificate2?> GetClientCertificateAsync ();

member this.GetClientCertificateAsync : unit -> System.Threading.Tasks.Task<System.Security.Cryptography.X509Certificates.X509Certificate2>

Public Function GetClientCertificateAsync () As Task(Of X509Certificate2)

傳回

Task<X509Certificate2>

工作物件，表示非同步作業。 工作物件上的 Result 屬性傳回包含用戶端之 X.509 v.3 憑證的 System.Security.Cryptography.X509Certificates 物件。

備註

這項作業不會封鎖。 傳回 Task<TResult> 的物件會在擷取憑證時完成。

如果呼叫這個方法以擷取用戶端的 X.509 v.3 憑證正在進行中，則無法對此方法進行另一個呼叫。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 ArgumentException，仍會同步擲回。 如需預存的例外狀況，請參閱 所 GetClientCertificate()擲回的例外狀況。

另請參閱

• System.Security.Cryptography.X509Certificates