CookieHandler.Write Método

Definición

Espacio de nombres:

System.IdentityModel.Services

Ensamblado:

System.IdentityModel.Services.dll

Escribe una cookie.

Sobrecargas

Nombre	Description
Write(Byte[], Boolean, DateTime)	Escribe una cookie asociada a la solicitud actual que tiene el valor, la persistencia y la hora de expiración especificados.
Write(Byte[], String, DateTime)	Escribe una cookie asociada a la solicitud actual que tiene el nombre, el valor y la hora 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 hora 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 hora 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 hora 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, solo es válida hasta que se cierre el explorador en el cliente.

tokenExpirationTime

DateTime

Hora de expiración del token subyacente.

Excepciones

ArgumentNullException

value está 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 si la cookie solo debe enviarse 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 hora 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

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

value está null o está vacío.

ArgumentException

name está null o está vacío.

Comentarios

El dominio y la ruta de acceso de las cookies 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 si la cookie solo debe enviarse 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 hora 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

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

para HttpContext la solicitud.

Excepciones

ArgumentNullException

value está null o está vacío.

ArgumentException

name está null o está vacío.

Comentarios

El dominio y la ruta de acceso de las cookies se especifican mediante las Domain propiedades y Path . La solicitud se especifica mediante Current. Si la propiedad especifica RequireSsl si la cookie solo debe enviarse 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 hora 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

Nombre de la cookie.

path

String

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

true si la cookie solo debe usarse a través de una conexión SSL; de lo contrario, false.

hideFromClientScript

Boolean

true si la cookie debe ocultarse del script de cliente; de lo contrario, false.

context

HttpContext

para HttpContext la solicitud.

Excepciones

ArgumentNullException

value está null o está vacío.

ArgumentException

name está null o está vacío.