CookieHandlerElement 類別

定義

命名空間:

System.IdentityModel.Services

組件:

System.IdentityModel.Services.dll

代表 <cookieHandler> 組態項目。

public ref class CookieHandlerElement : System::Configuration::ConfigurationElement

public class CookieHandlerElement : System.Configuration.ConfigurationElement

type CookieHandlerElement = class
    inherit ConfigurationElement

Public Class CookieHandlerElement
Inherits ConfigurationElement

繼承

Object

ConfigurationElement

CookieHandlerElement

備註

專案 <cookieHandler> 是 專案的子專案 <federatedAuthentication> ; FederationConfiguration.CookieHandler 屬性會設定為 類別的 CookieHandlerElement 實例。 元素 <cookieHandler> 可用來設定會話驗證模組所使用的 Cookie 處理程式， (SAM) ，此處理程式是由 SessionAuthenticationModule 類別表示。

Cookie 處理程式可以透過下列其中一種方式來設定：

• 若要設定區塊 Cookie 處理程式，請將 Mode 屬性設定為 Default 或 Chunked ，並使用區塊 Cookie 處理程式的組態項目來設定 ChunkedCookieHandler 屬性。 CustomCookieHandler不應該設定 屬性。

• 若要使用預設區塊大小來設定區塊化Cookie處理程式，您可以如先前所述設定 Mode 屬性，但同時保留 ChunkedCookieHandler 和 CustomCookieHandler 屬性未設定。

• 若要設定自定義 Cookie 處理程式，請將 Mode 屬性設定為 Custom ，並使用識別自定義 Cookie 處理程式類型的組態項目來設定 CustomCookieHandler 屬性。 此類型必須衍生自 CookieHandler 類別。 ChunkedCookieHandler不應該設定 屬性。

建構函式

CookieHandlerElement()

初始化 CookieHandlerElement 類別的新執行個體。

屬性

ChunkedCookieHandler	取得或設定區塊 cookie 處理常式。
CurrentConfiguration	取得最上層 Configuration 執行個體的參考，這個執行個體表示目前 ConfigurationElement 執行個體所屬的組態階層架構。 (繼承來源 ConfigurationElement)
CustomCookieHandler	取得或設定自訂 Cookie 處理常式型別。 正在設定自訂 Cookie 處理常式時，就必須設定這個屬性。
Domain	取得或設定處理常式所寫入的 cookie 的網域值。
ElementInformation	取得 ElementInformation 物件，其中包含 ConfigurationElement 物件之不可自訂的資訊和功能。 (繼承來源 ConfigurationElement)
ElementProperty	取得表示 ConfigurationElementProperty 物件本身的 ConfigurationElement 物件。 (繼承來源 ConfigurationElement)
EvaluationContext	取得 ConfigurationElement 物件的 ContextInformation 物件。 (繼承來源 ConfigurationElement)
HasContext	取得值，指出 CurrentConfiguration 屬性是否為 null。 (繼承來源 ConfigurationElement)
HideFromScript	取得或設定值，指定是否應該設定這個處理常式所寫入之 cookie 的 httpOnly 屬性。
Item[ConfigurationProperty]	取得或設定此組態項目的屬性 (Property) 或屬性 (Attribute)。 (繼承來源 ConfigurationElement)
Item[String]	取得或設定此一組態項目的屬性或子項目。 (繼承來源 ConfigurationElement)
LockAllAttributesExcept	取得已鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockAllElementsExcept	取得已鎖定項目的集合。 (繼承來源 ConfigurationElement)
LockAttributes	取得已鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockElements	取得已鎖定項目的集合。 (繼承來源 ConfigurationElement)
LockItem	取得或設定值，指出此項目是否已被鎖定。 (繼承來源 ConfigurationElement)
Mode	取得或設定 cookie 處理常式模式。
Name	取得或設定處理常式所寫入的任何 cookie 的基底名稱。
Path	取得或設定處理常式所寫入的 cookie 的路徑值。
PersistentSessionLifetime	取得或設定由處理常式所發出的 cookie 的存留期。
Properties	取得屬性的集合。 (繼承來源 ConfigurationElement)
RequireSsl	取得或設定值，這個值會指定是否只應搭配 SSL 使用 Cookie。

方法

DeserializeElement(XmlReader, Boolean)	從組態檔讀取 XML。 (繼承來源 ConfigurationElement)
Equals(Object)	將目前的 ConfigurationElement 執行個體與指定的物件相比較。 (繼承來源 ConfigurationElement)
GetConfiguredCookieHandler()	根據組態屬性，取得新的 cookie 處理常式。
GetHashCode()	取得表示目前 ConfigurationElement 執行個體的唯一值。 (繼承來源 ConfigurationElement)
GetTransformedAssemblyString(String)	傳回指定之組件名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetTransformedTypeString(String)	傳回指定之型別名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
Init()	將 ConfigurationElement 物件設定為它的初始狀態。 (繼承來源 ConfigurationElement)
InitializeDefault()	用來初始化 ConfigurationElement 物件的預設值集。 (繼承來源 ConfigurationElement)
IsModified()	在衍生類別中進行實作時，指出這個組態項目自上次儲存或載入後是否已修改。 (繼承來源 ConfigurationElement)
IsReadOnly()	取得值，這個值表示 ConfigurationElement 物件是否唯讀。 (繼承來源 ConfigurationElement)
ListErrors(IList)	將這個 ConfigurationElement 物件中和所有子項目中的無效屬性錯誤加入傳遞的清單。 (繼承來源 ConfigurationElement)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnDeserializeUnrecognizedAttribute(String, String)	取得值，指出在還原序列化程序中是否遇到未知的屬性 (Attribute)。 (繼承來源 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	取得值，指出在還原序列化程序中是否遇到未知的項目。 (繼承來源 ConfigurationElement)
OnRequiredPropertyNotFound(String)	在找不到必要的屬性時擲回例外狀況 (Exception)。 (繼承來源 ConfigurationElement)
PostDeserialize()	還原序列化之後呼叫。 (繼承來源 ConfigurationElement)
PreSerialize(XmlWriter)	序列化之前呼叫。 (繼承來源 ConfigurationElement)
Reset(ConfigurationElement)	重設 ConfigurationElement 物件的內部狀態，包括鎖定和屬性的集合。 (繼承來源 ConfigurationElement)
ResetModified()	在衍生類別中實作時，將 IsModified() 方法的值重設為 false。 (繼承來源 ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	在衍生類別中實作時，將此組態項目的內容寫入組態檔中。 (繼承來源 ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	在衍生類別中實作時，將此組態項目的外部標記寫入組態檔中。 (繼承來源 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	將屬性設定為指定的值。 (繼承來源 ConfigurationElement)
SetReadOnly()	設定 IsReadOnly() 物件和所有子項目的 ConfigurationElement 屬性。 (繼承來源 ConfigurationElement)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	修改 ConfigurationElement 物件，以移除不應該儲存的所有值。 (繼承來源 ConfigurationElement)

另請參閱

• <cookieHandler>