Cookie Constructores

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.Primitives.dll

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.

Cookie()

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 .

Cookie(String, String)

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

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

CookieException

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 el 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 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 objeto 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 utiliza como delimitador entre cookies independientes en la misma línea.

Consulte también

• CookieCollection
• CookieContainer
• CookieException

Cookie(String, String, String)

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

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

CookieException

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 el 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 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 objeto 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 utiliza como delimitador entre cookies independientes en la misma línea.

Consulte también

• CookieCollection
• CookieContainer
• CookieException

Cookie(String, String, String, String)

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

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

CookieException

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 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 objeto 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 utiliza como delimitador entre cookies independientes en la misma línea.

Consulte también

• CookieCollection
• CookieContainer
• CookieException