HttpCookiesSection Classe

Referência

Definição

Namespace:: System.Web.Configuration

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Configura as propriedades dos cookies usados por um aplicativo Web.

Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código.

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

Herança: Object

ConfigurationElement

ConfigurationSection
HttpCookiesSection

Exemplos

O exemplo de código a seguir mostra como obter o HttpCookiesSection objeto do arquivo de configuração de um aplicativo Web existente.


  // 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)

Comentários

A classe HttpCookiesSection oferece uma maneira de acessar e modificar programaticamente a seção httpCookies de um arquivo de configuração.

Ele define as configurações aplicadas por padrão a todos os cookies emitidos pelo aplicativo, a menos que o código emitindo o cookie os substitua.

Um objetivo do httpCookies elemento é dar suporte ao uso de HttpOnly cookies. HttpOnly cookies (cookies com o HttpOnly atributo) foram introduzidos no Internet Explorer 6 para ajudar a reduzir o risco de scripts entre sites. O HttpOnly atributo impede que cookies sejam acessados por meio do script do lado do cliente. Qualquer informação contida em um HttpOnly cookie é menos provável que seja divulgada para um hacker ou um site mal-intencionado. Para obter mais informações, pesquise no MSDN (msdn.microsoft.com) por "HttpOnly".

Observação

As HttpCookiesSection informações de leitura e gravação podem ser lidas de e para a seção relacionada do arquivo de configuração de acordo com a propriedade AllowDefinition da seção cujo valor é Everywhere.

Construtores

HttpCookiesSection()

Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código.

Inicializa uma nova instância da classe HttpCookiesSection.

Propriedades

CurrentConfiguration	Obtém uma referência para a instância Configuration de nível superior que representa a hierarquia de configuração à qual a instância atual ConfigurationElement pertence. (Herdado de ConfigurationElement)
Domain	Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código. Obtém ou define o nome de domínio do cookie.
ElementInformation	Obtém um objeto ElementInformation que contém as informações não personalizáveis e a funcionalidade do objeto ConfigurationElement. (Herdado de ConfigurationElement)
ElementProperty	Obtém o objeto ConfigurationElementProperty que representa o próprio objeto ConfigurationElement. (Herdado de ConfigurationElement)
EvaluationContext	Obtém o objeto ContextInformation para o objeto ConfigurationElement. (Herdado de ConfigurationElement)
HasContext	Obtém um valor que indica se a propriedade CurrentConfiguration é `null`. (Herdado de ConfigurationElement)
HttpOnlyCookies	Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código. Obtém ou define um valor que indica se o suporte para o cookie `HttpOnly` do navegador está habilitado.
Item[ConfigurationProperty]	Obtém ou define uma propriedade ou um atributo desse elemento de configuração. (Herdado de ConfigurationElement)
Item[String]	Obtém ou define uma propriedade, atributo ou elemento filho desse elemento de configuração. (Herdado de ConfigurationElement)
LockAllAttributesExcept	Obtém a coleção de atributos bloqueados. (Herdado de ConfigurationElement)
LockAllElementsExcept	Obtém a coleção de elementos bloqueados. (Herdado de ConfigurationElement)
LockAttributes	Obtém a coleção de atributos bloqueados. (Herdado de ConfigurationElement)
LockElements	Obtém a coleção de elementos bloqueados. (Herdado de ConfigurationElement)
LockItem	Obtém ou define um valor que indica se o elemento está bloqueado. (Herdado de ConfigurationElement)
Properties	Obtém a coleção de propriedades. (Herdado de ConfigurationElement)
RequireSSL	Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código. Obtém ou define um valor que indica se a comunicação do protocolo SSL é necessária.
SameSite	Obtém ou define o valor do atributo SameSite do cookie.
SectionInformation	Obtém um objeto SectionInformation que contém as informações não personalizáveis e a funcionalidade do objeto ConfigurationSection. (Herdado de ConfigurationSection)

Métodos

DeserializeElement(XmlReader, Boolean)	Lê o XML do arquivo de configuração. (Herdado de ConfigurationElement)
DeserializeSection(XmlReader)	Lê o XML do arquivo de configuração. (Herdado de ConfigurationSection)
Equals(Object)	Compara a instância ConfigurationElement atual com o objeto especificado. (Herdado de ConfigurationElement)
GetHashCode()	Obtém um valor exclusivo que representa a instância ConfigurationElement atual. (Herdado de ConfigurationElement)
GetRuntimeObject()	Retorna um objeto personalizado quando substituído em uma classe derivada. (Herdado de ConfigurationSection)
GetTransformedAssemblyString(String)	Retorna a versão transformada do nome do assembly especificado. (Herdado de ConfigurationElement)
GetTransformedTypeString(String)	Retorna a versão transformada do nome do tipo especificado. (Herdado de ConfigurationElement)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
Init()	Define o objeto ConfigurationElement para seu estado inicial. (Herdado de ConfigurationElement)
InitializeDefault()	Usado para inicializar um conjunto padrão de valores para o objeto ConfigurationElement. (Herdado de ConfigurationElement)
IsModified()	Indica se este elemento de configuração foi modificado desde a última vez em que foi salvo ou carregado quando implementado em uma classe derivada. (Herdado de ConfigurationSection)
IsReadOnly()	Obtém um valor que indica se o objeto ConfigurationElement é somente leitura. (Herdado de ConfigurationElement)
ListErrors(IList)	Adiciona os erros de propriedade inválida deste objeto ConfigurationElement e de todos os subelementos à lista passada. (Herdado de ConfigurationElement)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnDeserializeUnrecognizedAttribute(String, String)	Obtém um valor que indica se um atributo desconhecido é encontrado durante a desserialização. (Herdado de ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Obtém um valor que indica se um elemento desconhecido é encontrado durante a desserialização. (Herdado de ConfigurationElement)
OnRequiredPropertyNotFound(String)	Gera uma exceção quando uma propriedade necessária não é encontrada. (Herdado de ConfigurationElement)
PostDeserialize()	Chamado depois da desserialização. (Herdado de ConfigurationElement)
PreSerialize(XmlWriter)	Chamado antes da serialização. (Herdado de ConfigurationElement)
Reset(ConfigurationElement)	Redefine o estado interno do objeto ConfigurationElement, incluindo os bloqueios e as coleções de propriedades. (Herdado de ConfigurationElement)
ResetModified()	Redefine o valor do método IsModified() para `false` quando implementado em uma classe derivada. (Herdado de ConfigurationSection)
SerializeElement(XmlWriter, Boolean)	Grava o conteúdo desse elemento de configuração no arquivo de configuração quando implementado em uma classe derivada. (Herdado de ConfigurationElement)
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode)	Cria uma cadeia de caracteres XML que contém uma exibição não mesclada do objeto ConfigurationSection como uma única seção a ser gravada em um arquivo. (Herdado de ConfigurationSection)
SerializeToXmlElement(XmlWriter, String)	Grava as marcas externas desse elemento de configuração no arquivo de configuração quando implementado em uma classe derivada. (Herdado de ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Define uma propriedade para o valor especificado. (Herdado de ConfigurationElement)
SetReadOnly()	Define a propriedade IsReadOnly() para o objeto ConfigurationElement e para todos os subelementos. (Herdado de ConfigurationElement)
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)	Indica se o elemento especificado deve ser serializado quando a hierarquia de objeto de configuração é serializada para a versão de destino especificada do .NET Framework. (Herdado de ConfigurationSection)
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)	Indica se a propriedade especificada deve ser serializada quando a hierarquia de objetos de configuração é serializada para a versão de destino especificada do .NET Framework. (Herdado de ConfigurationSection)
ShouldSerializeSectionInTargetVersion(FrameworkName)	Indica se a instância atual ConfigurationSection deve ser serializada quando a hierarquia de objetos de configuração é serializada para a versão de destino especificada do .NET Framework. (Herdado de ConfigurationSection)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modifica o objeto ConfigurationElement para remover todos os valores que não devem ser salvos. (Herdado de ConfigurationElement)

Aplica-se a

Compartilhar via