HttpWebRequest.ClientCertificates Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur kumpulan sertifikat keamanan yang terkait dengan permintaan ini.
public:
property System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ ClientCertificates { System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ get(); void set(System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ value); };
public:
property System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ ClientCertificates { System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ get(); };
public System.Security.Cryptography.X509Certificates.X509CertificateCollection ClientCertificates { get; set; }
public System.Security.Cryptography.X509Certificates.X509CertificateCollection ClientCertificates { get; }
member this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollection with get, set
member this.ClientCertificates : System.Security.Cryptography.X509Certificates.X509CertificateCollection
Public Property ClientCertificates As X509CertificateCollection
Public ReadOnly Property ClientCertificates As X509CertificateCollection
Nilai Properti
X509CertificateCollection yang berisi sertifikat keamanan yang terkait dengan permintaan ini.
Pengecualian
Nilai yang ditentukan untuk operasi set adalah null
.
Keterangan
Hati
WebRequest
, HttpWebRequest
, ServicePoint
, dan WebClient
usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.
Aplikasi dapat menambahkan sertifikat ke koleksi, tetapi mungkin tidak memiliki hak akses ke dalamnya. Untuk menggunakan sertifikat yang terkandung dalam koleksi, aplikasi harus memiliki hak akses yang sama dengan entitas yang mengeluarkan sertifikat.
Nota
Framework menyimpan sesi SSL saat dibuat dan mencoba menggunakan kembali sesi yang di-cache untuk permintaan baru, jika memungkinkan. Saat mencoba menggunakan kembali sesi SSL, Kerangka Kerja menggunakan elemen pertama ClientCertificates (jika ada), atau mencoba menggunakan kembali sesi anonim jika ClientCertificates kosong.
Nota
Untuk alasan performa, Anda tidak boleh menambahkan sertifikat klien ke HttpWebRequest kecuali Anda tahu server akan memintanya.
Untuk contoh kode yang mengilustrasikan cara menghitung sertifikat di penyimpanan sertifikat klien, lihat kelas X509Certificate2Collection.