CookieHandler.Write Método

Definición

Espacio de nombres:

System.IdentityModel.Services

Ensamblado:

System.IdentityModel.Services.dll

Escribe una cookie.

Sobrecargas

Write(Byte[], Boolean, DateTime)	Escribe una cookie asociada a la solicitud actual que tiene el valor, la persistencia y la fecha de expiración especificados.
Write(Byte[], String, DateTime)	Escribe una cookie asociada a la solicitud actual que tiene el nombre, el valor y la fecha de expiración especificados.
Write(Byte[], String, DateTime, HttpContext)	Escribe una cookie asociada a la solicitud especificada que tiene el nombre, el valor y la fecha de expiración especificados.
Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	Escribe una cookie asociada a la solicitud especificada que tiene el nombre, el valor, el dominio, la ruta de acceso, la fecha de expiración y la visibilidad especificados.

Write(Byte[], Boolean, DateTime)

Escribe una cookie asociada a la solicitud actual que tiene el valor, la persistencia y la fecha de expiración especificados.

public:
 void Write(cli::array <System::Byte> ^ value, bool isPersistent, DateTime tokenExpirationTime);

public void Write (byte[] value, bool isPersistent, DateTime tokenExpirationTime);

member this.Write : byte[] * bool * DateTime -> unit

Public Sub Write (value As Byte(), isPersistent As Boolean, tokenExpirationTime As DateTime)

Parámetros

value

Byte[]

Valor de la cookie.

isPersistent

Boolean

true si la cookie es persistente; false si la cookie es solo de sesión, es decir, solamente es válida hasta que se cierre el explorador del cliente.

tokenExpirationTime

DateTime

Fecha de expiración para el token subyacente.

Excepciones

ArgumentNullException

El valor de value es null o está vacío.

Comentarios

Si el isPersistent parámetro es false, la hora de expiración de la cookie se establece DateTime.MinValueen . Si el isPersistent parámetro es true, la hora de expiración de la cookie se establece en el valor de la PersistentSessionLifetime propiedad si no null es o, si la PersistentSessionLifetime propiedad es null, la hora de expiración se establece en el valor del tokenExpirationTime parámetro .

Las propiedades , Domain, y Path especifican el nombre de la cookie, el dominio y la Nameruta de acceso. La solicitud se especifica mediante Current. Si la propiedad especifica RequireSsl la cookie solo a través de SSL y si la cookie debe ocultarse de los scripts del lado cliente se especifica mediante la HideFromClientScript propiedad .

Write(Byte[], String, DateTime)

Escribe una cookie asociada a la solicitud actual que tiene el nombre, el valor y la fecha de expiración especificados.

public:
 void Write(cli::array <System::Byte> ^ value, System::String ^ name, DateTime expirationTime);

public void Write (byte[] value, string name, DateTime expirationTime);

member this.Write : byte[] * string * DateTime -> unit

Public Sub Write (value As Byte(), name As String, expirationTime As DateTime)

Parámetros

value

Byte[]

Valor de la cookie.

name

String

El nombre de la cookie.

expirationTime

DateTime

La hora de expiración de la cookie o DateTime.MinValue para una cookie de sesión (solo sesión).

Excepciones

ArgumentNullException

El valor de value es null o está vacío.

ArgumentException

El valor de name es null o está vacío.

Comentarios

El dominio y la ruta de acceso de la cookie se especifican mediante las Domain propiedades y Path . La solicitud se especifica mediante HttpContext.Current. La solicitud se especifica mediante Current. Si la propiedad especifica RequireSsl la cookie solo a través de SSL y si la cookie debe ocultarse de los scripts del lado cliente se especifica mediante la HideFromClientScript propiedad .

Write(Byte[], String, DateTime, HttpContext)

Escribe una cookie asociada a la solicitud especificada que tiene el nombre, el valor y la fecha de expiración especificados.

public:
 void Write(cli::array <System::Byte> ^ value, System::String ^ name, DateTime expirationTime, System::Web::HttpContext ^ context);

public void Write (byte[] value, string name, DateTime expirationTime, System.Web.HttpContext context);

member this.Write : byte[] * string * DateTime * System.Web.HttpContext -> unit

Public Sub Write (value As Byte(), name As String, expirationTime As DateTime, context As HttpContext)

Parámetros

value

Byte[]

Valor de la cookie.

name

String

El nombre de la cookie.

expirationTime

DateTime

La hora de expiración de la cookie o DateTime.MinValue para una cookie de sesión (solo sesión).

context

HttpContext

HttpContext de la solicitud.

Excepciones

ArgumentNullException

El valor de value es null o está vacío.

ArgumentException

El valor de name es null o está vacío.

Comentarios

El dominio y la ruta de acceso de la cookie se especifican mediante las Domain propiedades y Path . La solicitud se especifica mediante Current. Si la propiedad especifica RequireSsl la cookie solo a través de SSL y si la cookie debe ocultarse de los scripts del lado cliente se especifica mediante la HideFromClientScript propiedad .

Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)

Escribe una cookie asociada a la solicitud especificada que tiene el nombre, el valor, el dominio, la ruta de acceso, la fecha de expiración y la visibilidad especificados.

public:
 void Write(cli::array <System::Byte> ^ value, System::String ^ name, System::String ^ path, System::String ^ domain, DateTime expirationTime, bool requiresSsl, bool hideFromClientScript, System::Web::HttpContext ^ context);

public void Write (byte[] value, string name, string path, string domain, DateTime expirationTime, bool requiresSsl, bool hideFromClientScript, System.Web.HttpContext context);

member this.Write : byte[] * string * string * string * DateTime * bool * bool * System.Web.HttpContext -> unit

Public Sub Write (value As Byte(), name As String, path As String, domain As String, expirationTime As DateTime, requiresSsl As Boolean, hideFromClientScript As Boolean, context As HttpContext)

Parámetros

value

Byte[]

Valor de la cookie.

name

String

El nombre de la cookie.

path

String

La ruta de acceso de la cookie.

domain

String

Dominio de la cookie.

expirationTime

DateTime

La hora de expiración de la cookie o DateTime.MinValue para una cookie de sesión (solo sesión).

requiresSsl

Boolean

Es true si la cookie solo se debe usar en una conexión SSL; de lo contrario, es false.

hideFromClientScript

Boolean

true si la cookie debe estar oculta del script de cliente; si no, false.

context

HttpContext

HttpContext de la solicitud.

Excepciones

ArgumentNullException

El valor de value es null o está vacío.

ArgumentException

El valor de name es null o está vacío.