Compartir vía


Cookie Constructores

Definición

Inicializa una nueva instancia de la clase Cookie. En general, una aplicación no necesita construir una clase Cookie, puesto que se crea automáticamente sobre la base del encabezado Set-Cookie recibido con la respuesta HTTP.

Sobrecargas

Cookie()

Inicializa una nueva instancia de la clase Cookie.

Cookie(String, String)

Inicializa una nueva instancia de la clase Cookie con un Name y una Value especificados.

Cookie(String, String, String)

Inicializa una nueva instancia de la clase Cookie con los objetos Name , Value y Path especificados.

Cookie(String, String, String, String)

Inicializa una nueva instancia de la clase Cookie con los objetos Name , Value , Path y Domain especificados.

Source:
Cookie.cs
Source:
Cookie.cs
Source:
Cookie.cs

Inicializa una nueva instancia de la clase Cookie.

public:
 Cookie();
public Cookie ();
Public Sub New ()

Comentarios

El constructor sin parámetros inicializa todos los campos en sus valores predeterminados, mediante cadenas vacías ("") para name, value, pathy domain. Tenga en cuenta que al menos la Name propiedad debe inicializarse antes de usar una instancia de la Cookie clase .

Se aplica a

Source:
Cookie.cs
Source:
Cookie.cs
Source:
Cookie.cs

Inicializa una nueva instancia de la clase Cookie con un Name y una Value especificados.

public:
 Cookie(System::String ^ name, System::String ^ value);
public Cookie (string name, string value);
public Cookie (string name, string? value);
new System.Net.Cookie : string * string -> System.Net.Cookie
Public Sub New (name As String, value As String)

Parámetros

name
String

Nombre de un objeto Cookie. Los caracteres siguientes no deben utilizarse dentro de name: signo igual, punto y coma, coma, nueva línea (\n), retorno (\r), tabulación (\t) y carácter de espacio. El carácter del signo de dólar ("$") no puede ser el primer carácter.

value
String

Valor de un objeto Cookie. Los caracteres siguientes no deben utilizarse dentro de value: coma y punto y coma.

Excepciones

El parámetro name es null.

o bien

La longitud del parámetro name es cero.

o bien

El parámetro name contiene un carácter no válido.

o bien

El parámetro value es null.

O bien

El parámetro value contiene una cadena no incluida entre comillas que contiene un carácter no válido.

Comentarios

El valor predeterminado del value parámetro usa la cadena vacía ("").

El value parámetro de un Cookie no debe ser una null referencia (Nothing en Visual Basic). Los caracteres de punto y coma (";") y coma (",") están reservados y no se pueden pasar en el value parámetro a menos que la cadena pasada en el value parámetro esté entre comillas dobles. Por lo tanto, el constructor de ejemplo siguiente se realizará correctamente, pero al intentar agregarlo Cookie a una CookieContainer instancia con los Add(Cookie) métodos o Add(Uri, Cookie) , se producirá un error en la operación y se producirá una excepción:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

Sin embargo, el siguiente constructor con estos caracteres especiales con caracteres de escape creará un Cookie que se puede agregar a una CookieContainer instancia de :

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

El carácter de coma se usa como delimitador entre cookies independientes en la misma línea.

Consulte también

Se aplica a

Source:
Cookie.cs
Source:
Cookie.cs
Source:
Cookie.cs

Inicializa una nueva instancia de la clase Cookie con los objetos Name , Value y Path especificados.

public:
 Cookie(System::String ^ name, System::String ^ value, System::String ^ path);
public Cookie (string name, string value, string path);
public Cookie (string name, string? value, string? path);
new System.Net.Cookie : string * string * string -> System.Net.Cookie
Public Sub New (name As String, value As String, path As String)

Parámetros

name
String

Nombre de un objeto Cookie. Los caracteres siguientes no deben utilizarse dentro de name: signo igual, punto y coma, coma, nueva línea (\n), retorno (\r), tabulación (\t) y carácter de espacio. El carácter del signo de dólar ("$") no puede ser el primer carácter.

value
String

Valor de un objeto Cookie. Los caracteres siguientes no deben utilizarse dentro de value: coma y punto y coma.

path
String

Subconjunto de identificadores URI del servidor de origen al que se aplica este objeto Cookie. El valor predeterminado es "/".

Excepciones

El parámetro name es null.

o bien

La longitud del parámetro name es cero.

o bien

El parámetro name contiene un carácter no válido.

o bien

El parámetro value es null.

O bien

El parámetro value contiene una cadena no incluida entre comillas que contiene un carácter no válido.

Comentarios

El valor predeterminado del path parámetro usa la cadena vacía ("").

El value parámetro de un Cookie no debe ser una null referencia (Nothing en Visual Basic). Los caracteres de punto y coma (";") y coma (",") están reservados y no se pueden pasar en el value parámetro a menos que la cadena pasada en el value parámetro esté entre comillas dobles. Por lo tanto, el constructor de ejemplo siguiente se realizará correctamente, pero al intentar agregarlo Cookie a una CookieContainer instancia con los Add(Cookie) métodos o Add(Uri, Cookie) , se producirá un error en la operación y se producirá una excepción:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456", "");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

Sin embargo, el siguiente constructor con estos caracteres especiales con caracteres de escape creará un Cookie que se puede agregar a una CookieContainer instancia de :

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"", "");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

El carácter de coma se usa como delimitador entre cookies independientes en la misma línea.

Consulte también

Se aplica a

Source:
Cookie.cs
Source:
Cookie.cs
Source:
Cookie.cs

Inicializa una nueva instancia de la clase Cookie con los objetos Name , Value , Path y Domain especificados.

public:
 Cookie(System::String ^ name, System::String ^ value, System::String ^ path, System::String ^ domain);
public Cookie (string name, string value, string path, string domain);
public Cookie (string name, string? value, string? path, string? domain);
new System.Net.Cookie : string * string * string * string -> System.Net.Cookie
Public Sub New (name As String, value As String, path As String, domain As String)

Parámetros

name
String

Nombre de un objeto Cookie. Los caracteres siguientes no deben utilizarse dentro de name: signo igual, punto y coma, coma, nueva línea (\n), retorno (\r), tabulación (\t) y carácter de espacio. El carácter del signo de dólar ("$") no puede ser el primer carácter.

value
String

Valor de un objeto Cookie. Los caracteres siguientes no deben utilizarse dentro de value: coma y punto y coma.

path
String

Subconjunto de identificadores URI del servidor de origen al que se aplica este objeto Cookie. El valor predeterminado es "/".

domain
String

Dominio de Internet opcional para el cual es válido este Cookie. El valor predeterminado es el host desde el que se recibió este objeto Cookie.

Excepciones

El parámetro name es null.

o bien

La longitud del parámetro name es cero.

o bien

El parámetro name contiene un carácter no válido.

o bien

El parámetro value es null.

O bien

El parámetro value contiene una cadena no incluida entre comillas que contiene un carácter no válido.

Comentarios

El valor predeterminado para los domain parámetros y path usa la cadena vacía ("").

El value parámetro de un Cookie no debe ser una null referencia (Nothing en Visual Basic). Los caracteres de punto y coma (";") y coma (",") están reservados y no se pueden pasar en el value parámetro a menos que la cadena pasada en el value parámetro esté entre comillas dobles. Por lo tanto, el constructor de ejemplo siguiente se realizará correctamente, pero al intentar agregarlo Cookie a una CookieContainer instancia con los Add(Cookie) métodos o Add(Uri, Cookie) , se producirá un error en la operación y se producirá una excepción:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456", "", "contoso.com");
new CookieContainer().Add(cookie);

Sin embargo, el siguiente constructor con estos caracteres especiales con caracteres de escape creará un Cookie que se puede agregar a una CookieContainer instancia de :

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"", "", "contoso.com");
new CookieContainer().Add(cookie);

El carácter de coma se usa como delimitador entre cookies independientes en la misma línea.

Consulte también

Se aplica a