CookieContainer Kelas
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.
Menyediakan kontainer untuk kumpulan CookieCollection objek.
public ref class CookieContainer
public ref class CookieContainer sealed
public class CookieContainer
[System.Serializable]
public class CookieContainer
public sealed class CookieContainer
type CookieContainer = class
[<System.Serializable>]
type CookieContainer = class
Public Class CookieContainer
Public NotInheritable Class CookieContainer
- Warisan
-
CookieContainer
- Atribut
Keterangan
CookieContainer adalah struktur data yang menyediakan penyimpanan untuk instans Cookie kelas, dan yang diakses dengan cara seperti database. CookieContainer memiliki batas kapasitas yang diatur saat kontainer dibuat atau diubah oleh properti.
Instans Cookie kelas ditambahkan ke kontainer berdasarkan URI asalnya. Ini ditambahkan ke internal CookieCollection yang terkait dengan URI. Cookie diambil dari kontainer berdasarkan URI sebagai CookieCollection, atau sebagai string yang dapat digunakan untuk mengirimkan HTTP WebRequests.
CookieContainer memiliki tiga properti yang mengatur volume konten kontainer: Capacity, , MaxCookieSizedan PerDomainCapacity. Nilai-nilai ini masing-masing memiliki pengaturan default 300, 4096, dan 20. Cookie Ketika ditambahkan ke kontainer, properti ini digunakan untuk menentukan apakah yang Cookie sudah terkandung dalam CookieContainer harus dibuang untuk memberi ruang bagi yang baru. Melacak CookieContainer setiap penambahan untuk memastikan bahwa tidak ada Capacity batas atau PerDomainCapacity terlampaui. Jika satu atau keduanya terlampaui, maka Cookie instans yang dipegang CookieContainer oleh dihapus. Pertama, kedaluwarsa Cookie dihapus. Jika kapasitas lebih lanjut harus ditangkap kembali, maka yang paling tidak baru digunakan CookieCollection dihapus menyeluruh.
Keselamatan Benang
Metode untuk menambahkan dan mengambil Cookie instans ke dan dari CookieContainer adalah utas-aman dan dapat digunakan secara bersamaan dari beberapa utas.
Note
Terlepas dari keamanan utas, berbagi CookieContainer instans yang tidak terduga dapat menyebabkan masalah saat bekerja dengan HttpClient dan HttpClientHandler atau SocketsHttpHandler, karena bagian dari aplikasi yang tidak dimaksudkan untuk berbagi cookie satu sama lain mungkin secara tidak sengaja melakukannya. Tidak disarankan untuk menggunakan cookie bersama dengan IHttpClientFactory.
Konstruktor
| Nama | Deskripsi |
|---|---|
| CookieContainer() |
Menginisialisasi instans baru dari kelas CookieContainer. |
| CookieContainer(Int32, Int32, Int32) |
Menginisialisasi instans CookieContainer baru kelas dengan properti tertentu. |
| CookieContainer(Int32) |
Menginisialisasi instans CookieContainer baru kelas dengan nilai tertentu untuk jumlah Cookie instans yang dapat ditahan kontainer. |
Bidang
| Nama | Deskripsi |
|---|---|
| DefaultCookieLengthLimit |
Mewakili ukuran maksimum default, dalam byte, dari Cookie instans yang dapat ditahan CookieContainer . Bidang ini konstan. |
| DefaultCookieLimit |
Mewakili jumlah Cookie maksimum default instans yang dapat ditangguhkan CookieContainer . Bidang ini konstan. |
| DefaultPerDomainCookieLimit |
Mewakili jumlah Cookie maksimum default instans yang dapat dirujuk CookieContainer per domain. Bidang ini konstan. |
Properti
| Nama | Deskripsi |
|---|---|
| Capacity |
Mendapatkan atau mengatur jumlah Cookie instans yang dapat ditangguhkan CookieContainer . |
| Count |
Mendapatkan jumlah Cookie instans yang saat ini dimiliki CookieContainer . |
| MaxCookieSize |
Mewakili panjang maksimum yang Cookiediizinkan dari . |
| PerDomainCapacity |
Mendapatkan atau mengatur jumlah Cookie instans yang dapat ditangguhkan CookieContainer per domain. |
Metode
| Nama | Deskripsi |
|---|---|
| Add(Cookie) |
Cookie Menambahkan ke CookieContainer. Metode ini menggunakan domain dari Cookie untuk menentukan koleksi domain mana yang akan diasosiasikan Cookie . |
| Add(CookieCollection) |
Menambahkan konten ke CookieCollectionCookieContainer. |
| Add(Uri, Cookie) |
Cookie Menambahkan ke CookieContainer untuk URI tertentu. |
| Add(Uri, CookieCollection) |
Menambahkan konten CookieCollection ke CookieContainer untuk URI tertentu. |
| Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
| GetAllCookies() |
Mendapatkan yang CookieCollection berisi semua Cookie instans dalam kontainer. |
| GetCookieHeader(Uri) |
Mendapatkan header cookie HTTP yang berisi cookie HTTP yang mewakili Cookie instans yang terkait dengan URI tertentu. |
| GetCookies(Uri) |
CookieCollection Mendapatkan yang berisi Cookie instans yang terkait dengan URI tertentu. |
| GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
| GetType() |
Mendapatkan Type instans saat ini. (Diperoleh dari Object) |
| MemberwiseClone() |
Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object) |
| SetCookies(Uri, String) |
Menambahkan instans Cookie untuk satu atau beberapa cookie dari header cookie HTTP ke CookieContainer untuk URI tertentu. |
| ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |