CookieHandler Sınıf

Başvuru

Tanım

Ad Alanı:: System.IdentityModel.Services

Bütünleştirilmiş Kod:: System.IdentityModel.Services.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

HTTP istemcisinde oturum tanımlama bilgilerini okumak, yazmak ve silmek için soyut bir temel sınıf sağlar.

public ref class CookieHandler abstract

public abstract class CookieHandler

type CookieHandler = class

Public MustInherit Class CookieHandler

Devralma: Object
CookieHandler

Türetilmiş: System.IdentityModel.Services.ChunkedCookieHandler

Örnekler

Aşağıdaki örnek, SAM'yi türünde MyNamespace.MyCustomCookieHandlerbir özel tanımlama bilgisi işleyicisi kullanacak şekilde yapılandırıyor.

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

Açıklamalar

SessionAuthenticationModule (SAM), HTTP istemcisinde CookieHandler öğesini içeren tanımlama bilgisini veya tanımlama bilgilerini okumak, yazmak ve silmek için sınıfının bir örneğini SessionSecurityToken kullanır. Oturum belirtecini içeren tanımlama bilgisi (veya oturum belirtecinin birkaç tanımlama bilgisine bölünmesi durumunda tanımlama bilgileri) oturum tanımlama bilgisi olarak bilinir.

Windows Identity Foundation (WIF), sınıfı tarafından uygulanan öbeklenmiş tanımlama bilgisi işleyicisi olarak adlandırılan bir tanımlama bilgisi işleyicisi ChunkedCookieHandler ile birlikte verilir. Öbeklenmiş tanımlama bilgisi işleyicisi, oturum belirtecini belirtilen öbek boyutuna göre bir veya daha fazla tanımlama bilgisi arasında böler. Bu, birçok tarayıcı tarafından uygulanan tek tek tanımlama bilgileriyle ilgili boyut sınırlamalarını karşılamaktır.

Kendi tanımlama bilgisi işleyicinizi oluşturmak için 'den CookieHandler türetebilirsiniz. Bunu yaptığınızda, oturum tanımlama bilgisini silme, okuma ve WriteCore yazma fiili işini gerçekleştirmek için , ReadCoreve yöntemlerini geçersiz kılmanız DeleteCoregerekir. Bu yöntemler genellikle tanımlama bilgisini koleksiyondan HttpRequest.Cookies okur ve koleksiyon aracılığıyla HttpResponse.Cookies tanımlama bilgilerini yazar veya siler. HttpContext İstek ve yanıta erişebileceğiniz nesne, bu yöntemlerin her birine parametre olarak sağlanır. Gerekli yöntemlere ek olarak, işleyicinizin davranışını özelleştirmek için isteğe bağlı olarak sınıfı tarafından CookieHandler kullanıma sunulan diğer sanal yöntem özelliklerini geçersiz kılabilirsiniz.

Oturum tanımlama bilgisi için varsayılan davranışı ve özellikleri belirten birkaç özellik sınıfı tarafından CookieHandler kullanıma sunulur. Name, Domainve Path özellikleri tanımlama bilgisinin temel adını, geçerli olduğu etki alanını ve istemcide depolandığı yolu verir. HideFromClientScript özelliği, tanımlama bilgisinin istemci tarafı betikleri için erişilebilir olup olmadığını belirtir. RequireSsl özelliği, tanımlama bilgisinin yalnızca güvenli (HTTPS) bağlantılar üzerinden iletilip aktarılmayacağını belirtir. Ayarlanırsa, PersistentSessionLifetime özelliği kalıcı oturumlar için süre sonunu ayarlamak için kullanılır; bu, tarayıcı kapatıldıktan sonra bile geçerli kalan oturumlar için kullanılır. Bu özelliklerin tümü genellikle işleyicinin "çekirdek" yöntemleri tarafından temel alınan HttpCookie nesnede (veya nesnelerinde) ayarlanan eşdeğer özelliklere sahiptir. Daha fazla bilgi için her özelliğin belgelerine bakın.

SAM tarafından kullanılan tanımlama bilgisi işleyicisi, cookieHandler> öğesi aracılığıyla< yapılandırmada belirtilebilir. Bu öğe tarafından ayarlanan tanımlama bilgisi işleyicisi, olay için FederatedAuthentication.FederationConfigurationCreated bir olay temsilcisinde değiştirilebilir veya doğrudan özelliği aracılığıyla SessionAuthenticationModule.CookieHandler ayarlanabilir veya erişilebilir.

Oluşturucular

CookieHandler()

sınıfını başlatmak için türetilmiş sınıflardaki oluşturuculardan çağrılır CookieHandler .

Özellikler

Domain	Tanımlama bilgileri için kullanılan etki alanını alır veya ayarlar.
HideFromClientScript	Tanımlama bilgisinin istemci betiğinden gizlenip gizlenmeyeceğini belirten bir değer alır veya ayarlar.
Name	İşleyici tarafından yazılan tanımlama bilgilerinin temel adını alır veya ayarlar.
Path	İşleyici tarafından yazılan tanımlama bilgileri için sanal yolu alır veya ayarlar.
PersistentSessionLifetime	Kalıcı oturumların ömrü. Sıfır ise, geçici oturumlar her zaman kullanılır.
RequireSsl	Tanımlama bilgisinin yalnızca SSL ile kullanılıp kullanılmayacağını belirten bir değer alır veya ayarlar.

Yöntemler

Delete()	Varsayılan ada, etki alanına ve yola sahip geçerli istekle ilişkili tanımlama bilgisini siler.
Delete(HttpContext)	Varsayılan ada, etki alanına ve yola sahip geçerli istekle ilişkili tanımlama bilgisini siler.
Delete(String)	Belirtilen ada ve varsayılan etki alanına ve yola sahip geçerli istekle ilişkili tanımlama bilgisini siler.
Delete(String, HttpContext)	Belirtilen ada ve varsayılan etki alanına ve yola sahip belirtilen istekle ilişkili tanımlama bilgisini siler.
Delete(String, String, String, HttpContext)	Belirtilen ada, yola ve etki alanına sahip belirtilen istekle ilişkili tanımlama bilgisini siler.
DeleteCore(String, String, String, HttpContext)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen ada, etki alanına ve yola sahip belirtilen istekle ilişkili tanımlama bilgisini siler.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MatchCookiePath(Uri, Uri)	Hedef etki alanı tanımlama bilgisi etki alanı içindeyse ve hedef yol tanımlama bilgisi yolu içindeyse, tanımlama bilgisi yolu bölümünün büyük/küçük harfle eşleşmesini sağlayın.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
Read()	Varsayılan ada sahip geçerli istekle ilişkili tanımlama bilgisini okur.
Read(HttpContext)	Varsayılan ada, etki alanına ve yola sahip geçerli istekle ilişkili tanımlama bilgisini okur.
Read(String)	Belirtilen ada sahip geçerli istekle ilişkili tanımlama bilgisini okur.
Read(String, HttpContext)	Belirtilen ada ve varsayılan etki alanına ve yola sahip belirtilen istekle ilişkili tanımlama bilgisini okur.
ReadCore(String, HttpContext)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen ada sahip ve belirtilen istekle ilişkili tanımlama bilgisini okur.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
Write(Byte[], Boolean, DateTime)	Belirtilen değere, kalıcılığa ve süre sonu süresine sahip geçerli istekle ilişkili bir tanımlama bilgisi yazar.
Write(Byte[], String, DateTime)	Belirtilen ada, değere ve süre sonu süresine sahip geçerli istekle ilişkili bir tanımlama bilgisi yazar.
Write(Byte[], String, DateTime, HttpContext)	Belirtilen ada, değere ve süre sonu süresine sahip belirtilen istekle ilişkilendirilmiş bir tanımlama bilgisi yazar.
Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	Belirtilen ada, değere, etki alanına, yola, süre sonu süresine ve görünürlüğe sahip belirtilen istekle ilişkili bir tanımlama bilgisi yazar.
WriteCore(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen ada, değere, etki alanına, yola, sona erme süresine, kalıcılığa ve görünürlüğe sahip belirtilen istekle ilişkili bir tanımlama bilgisi yazar.

Şunlara uygulanır