CookieHandler Sınıf

Tanım

Ad Alanı:

System.IdentityModel.Services

Bütünleştirilmiş Kod:

System.IdentityModel.Services.dll

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ılır.

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

Açıklamalar

SessionAuthenticationModule (SAM), HTTP istemcisini CookieHandler içeren SessionSecurityToken tanımlama bilgisini veya tanımlama bilgilerini okumak, yazmak ve silmek için sınıfının bir örneğini kullanır. Oturum belirtecini içeren tanımlama bilgisi (veya oturum belirtecinin birkaç tanımlama bilgisi arasında 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 işlemlerini 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 bir 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.

Birkaç özellik, oturum tanımlama bilgisi için varsayılan davranışı ve özellikleri belirten 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ı betikler tarafından 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 son kullanma süresini ayarlamak için kullanılır, yani tarayıcı kapatıldıktan sonra bile geçerli kalan oturumlar için. Bu özelliklerin tümü genellikle işleyicinin "çekirdek" yöntemleri tarafından temel alınan HttpCookie nesnede (veya nesnelerde) 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 bir olay temsilcisinde FederatedAuthentication.FederationConfigurationCreated değiştirilebilir veya doğrudan özelliği aracılığıyla SessionAuthenticationModule.CookieHandler ayarlanabilir veya erişilebilir.

Oluşturucular

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

Özellikler

Name	Description
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

Name	Description
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, 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.
Delete(String)	Belirtilen ada ve varsayılan etki alanına ve yola sahip geçerli 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()	Geçerli örneğin Type 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şin.
MemberwiseClone()	Geçerli Objectbasit 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, HttpContext)	Belirtilen ada ve varsayılan etki alanına ve yola sahip belirtilen istekle ilişkili tanımlama bilgisini okur.
Read(String)	Belirtilen ada sahip geçerli 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 olan ve belirtilen istekle ilişkili tanımlama bilgisini okur.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)
Write(Byte[], Boolean, DateTime)	Belirtilen değer, kalıcılık 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ş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, String, String, DateTime, Boolean, Boolean, HttpContext)	Belirtilen ada, değere, etki alanına, yola, sona erme 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, süre sonu süresine, kalıcılığa ve görünürlüğe sahip belirtilen istekle ilişkili bir tanımlama bilgisi yazar.

Ayrıca bkz.

• ChunkedCookieHandler
• <cookieHandler>