HttpCookiesSection 類別

定義

命名空間:

System.Web.Configuration

組件:

System.Web.dll

設定 Web 應用程式使用之 Cookie 的屬性。

此 API 支援此產品基礎結構，但無法直接用於程式碼之中。

public ref class HttpCookiesSection sealed : System::Configuration::ConfigurationSection

public sealed class HttpCookiesSection : System.Configuration.ConfigurationSection

type HttpCookiesSection = class
    inherit ConfigurationSection

Public NotInheritable Class HttpCookiesSection
Inherits ConfigurationSection

繼承

Object

ConfigurationElement

ConfigurationSection

HttpCookiesSection

範例

下列程式碼範例示範如何從現有 Web 應用程式的組態檔取得 HttpCookiesSection 物件。

  // Get the Web application configuration.
  System.Configuration.Configuration webConfig =
  WebConfigurationManager.OpenWebConfiguration("/aspnetTest");

  // Get the section.
  string configPath = "system.web/httpCookies";
  System.Web.Configuration.HttpCookiesSection httpCookiesSection =
  (System.Web.Configuration.HttpCookiesSection)webConfig.GetSection(
  configPath);

 ' Get the Web application configuration.
 Dim webConfig _
 As System.Configuration.Configuration = _
 WebConfigurationManager.OpenWebConfiguration("/aspnetTest")

 ' Get the section.
 Dim configPath As String _
 = "system.web/httpCookies"

 Dim httpCookiesSection _
 As System.Web.Configuration.HttpCookiesSection = _
 CType(webConfig.GetSection(configPath), _
 System.Web.Configuration.HttpCookiesSection)

備註

HttpCookiesSection 類別 (Class) 提供以程式的方法，存取和修改組態檔的 httpCookies 區段。

它會定義預設套用至應用程式所發出之所有 Cookie 的設定，除非發出 Cookie 的程式碼會覆寫這些設定。

元素 httpCookies 的其中一個目標是支援 Cookie 的使用 HttpOnly 。 HttpOnly Internet Explorer 6 中引進了具有 HttpOnly 屬性) 的 Cookie (Cookie，以協助降低跨網站腳本的風險。 屬性 HttpOnly 可防止 Cookie 透過用戶端腳本存取。 Cookie 中包含的 HttpOnly 任何資訊都不太可能向駭客或惡意網站揭露。 如需詳細資訊，請搜尋 MSDN (msdn.microsoft.com) 以取得 「HttpOnly」。

注意

HttpCookiesSection可以根據值為 Everywhere 的 section 屬性 AllowDefinition ，從 組態檔的相關區段讀取和寫入資訊。

建構函式

HttpCookiesSection()

此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 初始化 HttpCookiesSection 類別的新執行個體。

屬性

CurrentConfiguration	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得最上層 Configuration 執行個體的參考，這個執行個體表示目前 ConfigurationElement 執行個體所屬的組態階層架構。 (繼承來源 ConfigurationElement)
Domain	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得或設定 Cookie 網域名稱。
ElementInformation	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得 ElementInformation 物件，其中包含 ConfigurationElement 物件之不可自訂的資訊和功能。 (繼承來源 ConfigurationElement)
ElementProperty	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得表示 ConfigurationElementProperty 物件本身的 ConfigurationElement 物件。 (繼承來源 ConfigurationElement)
EvaluationContext	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得 ConfigurationElement 物件的 ContextInformation 物件。 (繼承來源 ConfigurationElement)
HasContext	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得值，指出 CurrentConfiguration 屬性是否為 null。 (繼承來源 ConfigurationElement)
HttpOnlyCookies	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得或設定值，指出是否啟用對瀏覽器的 HttpOnly Cookie 支援。
Item[ConfigurationProperty]	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得或設定此組態項目的屬性 (Property) 或屬性 (Attribute)。 (繼承來源 ConfigurationElement)
Item[String]	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得或設定此一組態項目的屬性或子項目。 (繼承來源 ConfigurationElement)
LockAllAttributesExcept	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得已鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockAllElementsExcept	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得已鎖定項目的集合。 (繼承來源 ConfigurationElement)
LockAttributes	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得已鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockElements	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得已鎖定項目的集合。 (繼承來源 ConfigurationElement)
LockItem	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得或設定值，指出此項目是否已被鎖定。 (繼承來源 ConfigurationElement)
Properties	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得屬性的集合。 (繼承來源 ConfigurationElement)
RequireSSL	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得或設定值，指出 Secure Sockets Layer (SSL) 通訊是否必要。
SameSite	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得或設定 Cookie 的 SameSite 屬性值。
SectionInformation	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得 SectionInformation 物件，該物件包含 ConfigurationSection 物件之不可自訂的資訊和功能。 (繼承來源 ConfigurationSection)

方法

DeserializeElement(XmlReader, Boolean)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 從組態檔讀取 XML。 (繼承來源 ConfigurationElement)
DeserializeSection(XmlReader)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 從組態檔讀取 XML。 (繼承來源 ConfigurationSection)
Equals(Object)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 將目前的 ConfigurationElement 執行個體與指定的物件相比較。 (繼承來源 ConfigurationElement)
GetHashCode()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得表示目前 ConfigurationElement 執行個體的唯一值。 (繼承來源 ConfigurationElement)
GetRuntimeObject()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 在衍生類別中覆寫時，傳回自訂物件。 (繼承來源 ConfigurationSection)
GetTransformedAssemblyString(String)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 傳回指定之組件名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetTransformedTypeString(String)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 傳回指定之型別名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetType()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得目前執行個體的 Type。 (繼承來源 Object)
Init()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 將 ConfigurationElement 物件設定為它的初始狀態。 (繼承來源 ConfigurationElement)
InitializeDefault()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 用來初始化 ConfigurationElement 物件的預設值集。 (繼承來源 ConfigurationElement)
IsModified()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 在衍生類別中進行實作時，指出這個組態項目自上次儲存或載入後是否已修改。 (繼承來源 ConfigurationSection)
IsReadOnly()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得值，這個值表示 ConfigurationElement 物件是否唯讀。 (繼承來源 ConfigurationElement)
ListErrors(IList)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 將這個 ConfigurationElement 物件中和所有子項目中的無效屬性錯誤加入傳遞的清單。 (繼承來源 ConfigurationElement)
MemberwiseClone()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 建立目前 Object 的淺層複製。 (繼承來源 Object)
OnDeserializeUnrecognizedAttribute(String, String)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得值，指出在還原序列化程序中是否遇到未知的屬性 (Attribute)。 (繼承來源 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得值，指出在還原序列化程序中是否遇到未知的項目。 (繼承來源 ConfigurationElement)
OnRequiredPropertyNotFound(String)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 在找不到必要的屬性時擲回例外狀況 (Exception)。 (繼承來源 ConfigurationElement)
PostDeserialize()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 還原序列化之後呼叫。 (繼承來源 ConfigurationElement)
PreSerialize(XmlWriter)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 序列化之前呼叫。 (繼承來源 ConfigurationElement)
Reset(ConfigurationElement)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 重設 ConfigurationElement 物件的內部狀態，包括鎖定和屬性的集合。 (繼承來源 ConfigurationElement)
ResetModified()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 在衍生類別中實作時，將 IsModified() 方法的值重設為 false。 (繼承來源 ConfigurationSection)
SerializeElement(XmlWriter, Boolean)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 在衍生類別中實作時，將此組態項目的內容寫入組態檔中。 (繼承來源 ConfigurationElement)
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 建立 XML 字串，在該字串的單一區段中，包含了要寫入檔案之 ConfigurationSection 物件的取消合併檢視。 (繼承來源 ConfigurationSection)
SerializeToXmlElement(XmlWriter, String)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 在衍生類別中實作時，將此組態項目的外部標記寫入組態檔中。 (繼承來源 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 將屬性設定為指定的值。 (繼承來源 ConfigurationElement)
SetReadOnly()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 設定 IsReadOnly() 物件和所有子項目的 ConfigurationElement 屬性。 (繼承來源 ConfigurationElement)
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 指出當設定物件階層針對指定的目標版本序列化.NET Framework時，是否應該序列化指定的專案。 (繼承來源 ConfigurationSection)
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 指出當設定物件階層針對指定的目標版本的.NET Framework序列化時，是否應該序列化指定的屬性。 (繼承來源 ConfigurationSection)
ShouldSerializeSectionInTargetVersion(FrameworkName)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 指出當設定物件階層針對指定的目標版本的.NET Framework序列化時，是否應該序列化目前的 ConfigurationSection 實例。 (繼承來源 ConfigurationSection)
ToString()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 傳回代表目前物件的字串。 (繼承來源 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 修改 ConfigurationElement 物件，以移除不應該儲存的所有值。 (繼承來源 ConfigurationElement)

另請參閱

• HttpCookie
• HttpCookieMode
• ASP.NET 網頁狀態管理簡介