HttpCookieCollection Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece uma forma segura de tipos para manipular cookies HTTP.
public ref class HttpCookieCollection sealed : System::Collections::Specialized::NameObjectCollectionBasepublic sealed class HttpCookieCollection : System.Collections.Specialized.NameObjectCollectionBasetype HttpCookieCollection = class
inherit NameObjectCollectionBasePublic NotInheritable Class HttpCookieCollection
Inherits NameObjectCollectionBase- Herança
Exemplos
O exemplo de código seguinte demonstra como ler cookies usando a Cookies propriedade do HttpRequest objeto e escrever cookies usando a Cookies propriedade do HttpResponse objeto. Ambas as propriedades retornam HttpCookieCollection objetos. Se algum dos dois cookies nomeados userName e lastVisit não estiverem no pedido HTTP, então são criados na resposta HTTP. Se os dois cookies existirem, as propriedades dos cookies são exibidas.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void Page_Load(object sender, EventArgs e)
{
StringBuilder sb = new StringBuilder();
// Check to see if cookies exist in HTTP request.
if (Request.Cookies["userName"] == null &&
Request.Cookies["lastVist"] == null)
{
Response.Cookies["userName"].Value = "user name";
Response.Cookies["userName"].Expires = DateTime.Now.AddMinutes(20d);
HttpCookie aCookie = new HttpCookie("lastVisit");
aCookie.Value = DateTime.Now.ToString();
aCookie.Expires = DateTime.Now.AddMinutes(20d);
Response.Cookies.Add(aCookie);
sb.Append("Two cookies added to response. " +
"Refresh the page to read the cookies.");
}
else
{
HttpCookieCollection cookies = Request.Cookies;
for (int i = 0; i < cookies.Count; i++)
{
sb.Append("Name: " + cookies[i].Name + "<br/>");
sb.Append("Value: " + cookies[i].Value + "<br/>");
sb.Append("Expires: " + cookies[i].Expires.ToString() +
"<br/><br/>");
}
}
Label1.Text = sb.ToString();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>HttpCookieCollection Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:Label id="Label1" runat="server"></asp:Label>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
Dim sb As New StringBuilder()
' Check to see if cookies exist in HTTP request.
If (Request.Cookies("userName") Is Nothing AndAlso _
Request.Cookies("lastVisit") Is Nothing) Then
Response.Cookies("userName").Value = "user name"
Response.Cookies("userName").Expires = DateTime.Now.AddMinutes(20D)
Dim aCookie As HttpCookie
aCookie = New HttpCookie("lastVisit")
aCookie.Value = DateTime.Now.ToString()
aCookie.Expires = DateTime.Now.AddMinutes(20D)
Response.Cookies.Add(aCookie)
sb.Append("Two cookies added to response. " & _
"Refresh the page to read the cookies.")
Else
Dim cookies As HttpCookieCollection
cookies = Request.Cookies
For i As Integer = 0 To cookies.Count - 1
sb.Append("Name: " & cookies(i).Name & "<br/>")
sb.Append("Value: " & cookies(i).Value & "<br/>")
sb.Append("Expires: " & cookies(i).Expires.ToString() & _
"<br/><br/>")
Next
End If
Label1.Text = sb.ToString()
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>HttpCookieCollection Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:Label id="Label1" runat="server"></asp:Label>
</div>
</form>
</body>
</html>
Construtores
| Name | Description |
|---|---|
| HttpCookieCollection() |
Inicializa uma nova instância da HttpCookieCollection classe. |
Propriedades
| Name | Description |
|---|---|
| AllKeys |
Obtém um array de strings contendo todas as chaves (nomes de cookies) da coleção de cookies. |
| Count |
Obtém o número de pares chave/valor contidos na NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase) |
| IsReadOnly |
Recebe ou define um valor que indica se a NameObjectCollectionBase instância é apenas leitura. (Herdado de NameObjectCollectionBase) |
| Item[Int32] |
Obtém o cookie com o índice numérico especificado da coleção de cookies. |
| Item[String] |
Recebe o cookie com o nome especificado da coleção de cookies. |
| Keys |
Obtém uma NameObjectCollectionBase.KeysCollection instância que contém todas as chaves da NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase) |
Métodos
| Name | Description |
|---|---|
| Add(HttpCookie) |
Adiciona o cookie especificado à coleção de cookies. |
| BaseAdd(String, Object) |
Adiciona uma entrada com a chave e o valor especificados à NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase) |
| BaseClear() |
Remove todas as entradas da NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase) |
| BaseGet(Int32) |
Obtém o valor da entrada no índice especificado da NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase) |
| BaseGet(String) |
Obtém o valor da primeira entrada com a chave especificada da NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase) |
| BaseGetAllKeys() |
Devolve um String array que contém todas as chaves da NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase) |
| BaseGetAllValues() |
Devolve um Object array que contém todos os valores da NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase) |
| BaseGetAllValues(Type) |
Devolve um array do tipo especificado que contém todos os valores da NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase) |
| BaseGetKey(Int32) |
Obtém a chave da entrada no índice especificado da NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase) |
| BaseHasKeys() |
Obtém um valor que indica se a NameObjectCollectionBase instância contém entradas cujas chaves não |
| BaseRemove(String) |
Remove as entradas com a chave especificada da NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase) |
| BaseRemoveAt(Int32) |
Remove a entrada no índice especificado da NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase) |
| BaseSet(Int32, Object) |
Define o valor da entrada no índice especificado da NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase) |
| BaseSet(String, Object) |
Define o valor da primeira entrada com a chave especificada na NameObjectCollectionBase instância, se encontrada; caso contrário, adiciona uma entrada com a chave e valor especificados à NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase) |
| Clear() |
Apaga todos os cookies da coleção de cookies. |
| CopyTo(Array, Int32) |
Copia os membros da coleção de cookies para um Array início no índice especificado do array. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| Get(Int32) |
Devolve o HttpCookie item com o índice especificado da coleção de cookies. |
| Get(String) |
Devolve o cookie com o nome especificado da coleção de cookies. |
| GetEnumerator() |
Devolve um enumerador que itera através do NameObjectCollectionBase. (Herdado de NameObjectCollectionBase) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetKey(Int32) |
Devolve a chave (nome) do cookie no índice numérico especificado. |
| GetObjectData(SerializationInfo, StreamingContext) |
Implementa a ISerializable interface e devolve os dados necessários para serializar a NameObjectCollectionBase instância. (Herdado de NameObjectCollectionBase) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| OnDeserialization(Object) |
Implementa a ISerializable interface e levanta o evento de desserialização quando a desserialização está concluída. (Herdado de NameObjectCollectionBase) |
| Remove(String) |
Remove o cookie com o nome especificado da coleção. |
| Set(HttpCookie) |
Atualiza o valor de um cookie existente numa coleção de cookies. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| ICollection.CopyTo(Array, Int32) |
Copia a totalidade NameObjectCollectionBase para uma unidimensional Arraycompatível , começando no índice especificado do array alvo. (Herdado de NameObjectCollectionBase) |
| ICollection.IsSynchronized |
Recebe um valor que indica se o acesso ao NameObjectCollectionBase objeto está sincronizado (thread safe). (Herdado de NameObjectCollectionBase) |
| ICollection.SyncRoot |
Obtém um objeto que pode ser usado para sincronizar o acesso ao NameObjectCollectionBase objeto. (Herdado de NameObjectCollectionBase) |
Métodos da Extensão
| Name | Description |
|---|---|
| AsParallel(IEnumerable) |
Permite a paralelização de uma consulta. |
| AsQueryable(IEnumerable) |
Converte um IEnumerable para um IQueryable. |
| Cast<TResult>(IEnumerable) |
Conjura os elementos de an IEnumerable para o tipo especificado. |
| OfType<TResult>(IEnumerable) |
Filtra os elementos de um IEnumerable com base num tipo especificado. |