Freigeben über


CookieHandler.Write Methode

Definition

Schreibt ein Cookie.

Überlädt

Name Beschreibung
Write(Byte[], Boolean, DateTime)

Schreibt ein Cookie, das der aktuellen Anforderung zugeordnet ist, die den angegebenen Wert, die Persistenz und die Ablaufzeit aufweist.

Write(Byte[], String, DateTime)

Schreibt ein Cookie, das der aktuellen Anforderung zugeordnet ist, die den angegebenen Namen, den Wert und die Ablaufzeit enthält.

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

Schreibt ein Cookie, das der angegebenen Anforderung zugeordnet ist, die den angegebenen Namen, den Wert und die Ablaufzeit enthält.

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

Schreibt ein Cookie, das der angegebenen Anforderung zugeordnet ist, die den angegebenen Namen, Wert, Domäne, Pfad, Ablaufzeit und Sichtbarkeit enthält.

Write(Byte[], Boolean, DateTime)

Schreibt ein Cookie, das der aktuellen Anforderung zugeordnet ist, die den angegebenen Wert, die Persistenz und die Ablaufzeit aufweist.

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)

Parameter

value
Byte[]

Der Cookiewert.

isPersistent
Boolean

true wenn der Cookie dauerhaft ist; false wenn das Cookie sitzungsgeschützt ist, d. h. nur gültig, bis der Browser auf dem Client geschlossen wird.

tokenExpirationTime
DateTime

Die Ablaufzeit für das zugrunde liegende Token.

Ausnahmen

value ist null oder leer.

Hinweise

Wenn der isPersistent Parameter lautetfalse, wird die Cookie-Ablaufzeit auf .DateTime.MinValue Wenn der isPersistent Parameter lautet true, wird die Cookie-Ablaufzeit auf den Wert der PersistentSessionLifetime Eigenschaft festgelegt, wenn er nicht null oder, wenn die PersistentSessionLifetime Eigenschaft ist null, die Ablaufzeit auf den Wert des tokenExpirationTime Parameters festgelegt wird.

Der Cookiename, die Domäne und der Pfad werden durch die NameEigenschaften Domainund Path Eigenschaften angegeben. Die Anforderung wird durch Current. Ob das Cookie nur über SSL gesendet werden soll, wird durch die RequireSsl Eigenschaft angegeben und ob das Cookie von clientseitigen Skripts ausgeblendet werden soll, wird von der HideFromClientScript Eigenschaft angegeben.

Gilt für:

Write(Byte[], String, DateTime)

Schreibt ein Cookie, das der aktuellen Anforderung zugeordnet ist, die den angegebenen Namen, den Wert und die Ablaufzeit enthält.

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)

Parameter

value
Byte[]

Der Cookiewert.

name
String

Der Name des Cookies.

expirationTime
DateTime

Die Ablaufzeit für das Cookie oder DateTime.MinValue für ein Sitzungscookies (nur sitzungsgeschützt).

Ausnahmen

value ist null oder leer.

name ist null oder leer.

Hinweise

Die Cookie-Domäne und der Pfad werden durch die und Path die Domain Eigenschaften angegeben. Die Anforderung wird durch HttpContext.Current. Die Anforderung wird durch Current. Ob das Cookie nur über SSL gesendet werden soll, wird durch die RequireSsl Eigenschaft angegeben und ob das Cookie von clientseitigen Skripts ausgeblendet werden soll, wird von der HideFromClientScript Eigenschaft angegeben.

Gilt für:

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

Schreibt ein Cookie, das der angegebenen Anforderung zugeordnet ist, die den angegebenen Namen, den Wert und die Ablaufzeit enthält.

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)

Parameter

value
Byte[]

Der Cookiewert.

name
String

Der Name des Cookies.

expirationTime
DateTime

Die Ablaufzeit für das Cookie oder DateTime.MinValue für ein Sitzungscookies (nur sitzungsgeschützt).

context
HttpContext

Die HttpContext für die Anforderung.

Ausnahmen

value ist null oder leer.

name ist null oder leer.

Hinweise

Die Cookie-Domäne und der Pfad werden durch die und Path die Domain Eigenschaften angegeben. Die Anforderung wird durch Current. Ob das Cookie nur über SSL gesendet werden soll, wird durch die RequireSsl Eigenschaft angegeben und ob das Cookie von clientseitigen Skripts ausgeblendet werden soll, wird von der HideFromClientScript Eigenschaft angegeben.

Gilt für:

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

Schreibt ein Cookie, das der angegebenen Anforderung zugeordnet ist, die den angegebenen Namen, Wert, Domäne, Pfad, Ablaufzeit und Sichtbarkeit enthält.

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)

Parameter

value
Byte[]

Der Cookiewert.

name
String

Der Name des Cookies.

path
String

Der Pfad für das Cookie.

domain
String

Die Domäne für das Cookie.

expirationTime
DateTime

Die Ablaufzeit für das Cookie oder DateTime.MinValue für ein Sitzungscookies (nur sitzungsgeschützt).

requiresSsl
Boolean

truewenn das Cookie nur über eine SSL-Verbindung verwendet werden soll; andernfalls . false

hideFromClientScript
Boolean

truewenn das Cookie vom Clientskript ausgeblendet werden soll; andernfalls . false

context
HttpContext

Die HttpContext für die Anforderung.

Ausnahmen

value ist null oder leer.

name ist null oder leer.

Gilt für: