CookieHandler Kelas

Referensi

Definisi

Ruang nama:: System.IdentityModel.Services

Rakitan:: System.IdentityModel.Services.dll

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 kelas dasar abstrak untuk membaca, menulis, dan menghapus cookie sesi pada klien HTTP.

public ref class CookieHandler abstract

public abstract class CookieHandler

type CookieHandler = class

Public MustInherit Class CookieHandler

Warisan: Object
CookieHandler

Turunan: System.IdentityModel.Services.ChunkedCookieHandler

Contoh

Contoh berikut mengonfigurasi SAM untuk menggunakan penangan cookie kustom jenis MyNamespace.MyCustomCookieHandler.

<cookieHandler mode="Custom">  
    <customCookieHandler type="MyNamespace.MyCustomCookieHandler, MyAssembly" />  
</cookieHandler>

Keterangan

SessionAuthenticationModule (SAM) menggunakan instans CookieHandler kelas untuk membaca, menulis, dan menghapus cookie atau cookie yang berisi SessionSecurityToken pada klien HTTP. Cookie (atau cookie, dalam kasus di mana token sesi dibagi di beberapa cookie) yang berisi token sesi dikenal sebagai cookie sesi.

Windows Identity Foundation (WIF) dikirim dengan handler cookie yang disebut handler cookie terpotong yang diimplementasikan oleh ChunkedCookieHandler kelas . Handler cookie yang dipotong membagi token sesi di satu atau beberapa cookie sesuai dengan ukuran gugus yang ditentukan. Ini untuk memenuhi batasan ukuran pada cookie individu yang diberlakukan oleh banyak browser.

Anda dapat memperoleh dari CookieHandler untuk membuat handler cookie Anda sendiri. Ketika Anda melakukannya, Anda harus mengambil alih DeleteCoremetode , ReadCore, dan WriteCore untuk melakukan pekerjaan aktual menghapus, membaca, dan menulis cookie sesi. Metode ini biasanya membaca cookie dari HttpRequest.Cookies koleksi dan menulis atau menghapus cookie melalui HttpResponse.Cookies koleksi. Objek HttpContext tempat Anda dapat mengakses permintaan dan respons disediakan sebagai parameter untuk masing-masing metode ini. Selain metode yang diperlukan, Anda dapat secara opsional mengganti properti metode virtual lain yang diekspos oleh CookieHandler kelas untuk menyesuaikan perilaku handler Anda.

Beberapa properti diekspos oleh CookieHandler kelas yang menentukan perilaku default dan properti untuk cookie sesi. Properti Name, Domain, dan Path menyediakan nama dasar untuk cookie, domain tempatnya valid dan jalur tempatnya disimpan pada klien. Properti HideFromClientScript menentukan apakah cookie dapat diakses oleh skrip sisi klien. Properti RequireSsl menentukan apakah cookie harus dikirimkan hanya melalui koneksi aman (HTTPS). Jika diatur, PersistentSessionLifetime properti digunakan untuk mengatur waktu kedaluwarsa untuk sesi persisten, yaitu untuk sesi yang tetap valid bahkan setelah browser ditutup. Semua properti ini memiliki properti yang setara yang biasanya diatur pada HttpCookie objek dasar (atau objek) dengan metode "inti" dari handler. Untuk informasi selengkapnya, lihat dokumentasi untuk setiap properti.

Handler cookie yang digunakan oleh SAM dapat ditentukan dalam konfigurasi melalui <elemen cookieHandler> . Handler cookie yang ditetapkan oleh elemen ini dapat dimodifikasi dalam delegasi peristiwa untuk peristiwa tersebut FederatedAuthentication.FederationConfigurationCreated atau dapat diatur atau diakses langsung melalui SessionAuthenticationModule.CookieHandler properti .

Konstruktor

CookieHandler()

Dipanggil dari konstruktor di kelas turunan CookieHandler untuk menginisialisasi kelas.

Properti

Domain	Mendapatkan atau mengatur domain yang digunakan untuk cookie.
HideFromClientScript	Mendapatkan atau menetapkan nilai yang menunjukkan apakah cookie harus disembunyikan dari skrip klien.
Name	Mendapatkan atau mengatur nama dasar untuk cookie yang ditulis oleh handler.
Path	Mendapatkan atau mengatur jalur virtual untuk cookie yang ditulis oleh handler.
PersistentSessionLifetime	Masa pakai sesi persisten. Jika nol, sesi sementara selalu digunakan.
RequireSsl	Mendapatkan atau menetapkan nilai yang menentukan apakah cookie harus digunakan hanya dengan SSL.

Metode

Delete()	Menghapus cookie yang terkait dengan permintaan saat ini yang memiliki nama, domain, dan jalur default.
Delete(HttpContext)	Menghapus cookie yang terkait dengan permintaan saat ini yang memiliki nama, domain, dan jalur default.
Delete(String)	Menghapus cookie yang terkait dengan permintaan saat ini yang memiliki nama yang ditentukan serta domain dan jalur default.
Delete(String, HttpContext)	Menghapus cookie yang terkait dengan permintaan yang ditentukan yang memiliki nama yang ditentukan serta domain dan jalur default.
Delete(String, String, String, HttpContext)	Menghapus cookie yang terkait dengan permintaan yang ditentukan yang memiliki nama, jalur, dan domain yang ditentukan.
DeleteCore(String, String, String, HttpContext)	Saat ditimpa di kelas turunan, menghapus cookie yang terkait dengan permintaan yang ditentukan yang memiliki nama, domain, dan jalur yang ditentukan.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MatchCookiePath(Uri, Uri)	Jika domain target berada dalam domain cookie dan jalur target berada dalam jalur cookie, cocok dengan casing bagian jalur cookie.
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
Read()	Membaca cookie yang terkait dengan permintaan saat ini yang memiliki nama default.
Read(HttpContext)	Membaca cookie yang terkait dengan permintaan saat ini yang memiliki nama, domain, dan jalur default.
Read(String)	Membaca cookie yang terkait dengan permintaan saat ini yang memiliki nama yang ditentukan.
Read(String, HttpContext)	Membaca cookie yang terkait dengan permintaan yang ditentukan yang memiliki nama yang ditentukan serta domain dan jalur default.
ReadCore(String, HttpContext)	Ketika ditimpa di kelas turunan, membaca cookie yang memiliki nama yang ditentukan dan yang terkait dengan permintaan yang ditentukan.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
Write(Byte[], Boolean, DateTime)	Menulis cookie yang terkait dengan permintaan saat ini yang memiliki nilai, persistensi, dan waktu kedaluwarsa yang ditentukan.
Write(Byte[], String, DateTime)	Menulis cookie yang terkait dengan permintaan saat ini yang memiliki nama, nilai, dan waktu kedaluwarsa yang ditentukan.
Write(Byte[], String, DateTime, HttpContext)	Menulis cookie yang terkait dengan permintaan yang ditentukan yang memiliki nama, nilai, dan waktu kedaluwarsa yang ditentukan.
Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	Menulis cookie yang terkait dengan permintaan yang ditentukan yang memiliki nama, nilai, domain, jalur, waktu kedaluwarsa, dan visibilitas yang ditentukan.
WriteCore(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	Saat ditimpa di kelas turunan, tulis cookie yang terkait dengan permintaan yang ditentukan yang memiliki nama, nilai, domain, jalur, waktu kedaluwarsa, persistensi, dan visibilitas yang ditentukan.

Berlaku untuk

Bagikan melalui