CookieHandler.Write Metoda

Definicja

Przestrzeń nazw:

System.IdentityModel.Services

Zestaw:

System.IdentityModel.Services.dll

Zapisuje plik cookie.

Przeciążenia

Write(Byte[], Boolean, DateTime)	Zapisuje plik cookie skojarzony z bieżącym żądaniem, które ma określoną wartość, trwałość i czas wygaśnięcia.
Write(Byte[], String, DateTime)	Zapisuje plik cookie skojarzony z bieżącym żądaniem o określonej nazwie, wartości i czasie wygaśnięcia.
Write(Byte[], String, DateTime, HttpContext)	Zapisuje plik cookie skojarzony z określonym żądaniem o określonej nazwie, wartości i czasie wygaśnięcia.
Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	Zapisuje plik cookie skojarzony z określonym żądaniem o określonej nazwie, wartości, domenie, ścieżce, czasie wygaśnięcia i widoczności.

Write(Byte[], Boolean, DateTime)

Zapisuje plik cookie skojarzony z bieżącym żądaniem, które ma określoną wartość, trwałość i czas wygaśnięcia.

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)

Parametry

value

Byte[]

Wartość pliku cookie.

isPersistent

Boolean

true jeżeli plik cookie jest trwały; false jeśli plik cookie jest tylko sesją, oznacza to, że jest prawidłowy tylko do momentu zamknięcia przeglądarki na kliencie.

tokenExpirationTime

DateTime

Czas wygaśnięcia tokenu bazowego.

Wyjątki

ArgumentNullException

value wartość jest pusta lub jest null pusta.

Uwagi

isPersistent Jeśli parametr to false, czas wygaśnięcia pliku cookie jest ustawiony na DateTime.MinValuewartość . isPersistent Jeśli parametr to true, czas wygaśnięcia pliku cookie jest ustawiony na wartość PersistentSessionLifetime właściwości, jeśli nie null jest lub, jeśli PersistentSessionLifetime właściwość ma nullwartość , czas wygaśnięcia jest ustawiony na wartość parametrutokenExpirationTime.

Nazwa pliku cookie, domena i ścieżka są określane przez Namewłaściwości , Domaini Path . Żądanie jest określone przez Current. Czy plik cookie powinien być wysyłany tylko za pośrednictwem protokołu SSL, jest określony przez RequireSsl właściwość i czy plik cookie powinien być ukryty przed skryptami po stronie klienta jest określony przez HideFromClientScript właściwość .

Write(Byte[], String, DateTime)

Zapisuje plik cookie skojarzony z bieżącym żądaniem o określonej nazwie, wartości i czasie wygaśnięcia.

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)

Parametry

value

Byte[]

Wartość pliku cookie.

name

String

Nazwa pliku cookie.

expirationTime

DateTime

Czas wygaśnięcia pliku cookie lub DateTime.MinValue dla pliku cookie sesji (tylko sesja).

Wyjątki

ArgumentNullException

value wartość jest pusta lub jest null pusta.

ArgumentException

name wartość jest pusta lub jest null pusta.

Uwagi

Domena i ścieżka pliku cookie są określane przez Domain właściwości i Path . Żądanie jest określone przez HttpContext.Current. Żądanie jest określone przez Current. Czy plik cookie powinien być wysyłany tylko za pośrednictwem protokołu SSL, jest określony przez RequireSsl właściwość i czy plik cookie powinien być ukryty przed skryptami po stronie klienta jest określony przez HideFromClientScript właściwość .

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

Zapisuje plik cookie skojarzony z określonym żądaniem o określonej nazwie, wartości i czasie wygaśnięcia.

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)

Parametry

value

Byte[]

Wartość pliku cookie.

name

String

Nazwa pliku cookie.

expirationTime

DateTime

Czas wygaśnięcia pliku cookie lub DateTime.MinValue dla pliku cookie sesji (tylko sesja).

context

HttpContext

Element HttpContext dla żądania.

Wyjątki

ArgumentNullException

value wartość jest pusta lub jest null pusta.

ArgumentException

name wartość jest pusta lub jest null pusta.

Uwagi

Domena i ścieżka pliku cookie są określane przez Domain właściwości i Path . Żądanie jest określone przez Current. Czy plik cookie powinien być wysyłany tylko za pośrednictwem protokołu SSL, jest określony przez RequireSsl właściwość i czy plik cookie powinien być ukryty przed skryptami po stronie klienta jest określony przez HideFromClientScript właściwość .

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

Zapisuje plik cookie skojarzony z określonym żądaniem o określonej nazwie, wartości, domenie, ścieżce, czasie wygaśnięcia i widoczności.

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)

Parametry

value

Byte[]

Wartość pliku cookie.

name

String

Nazwa pliku cookie.

path

String

Ścieżka pliku cookie.

domain

String

Domena pliku cookie.

expirationTime

DateTime

Czas wygaśnięcia pliku cookie lub DateTime.MinValue dla pliku cookie sesji (tylko sesja).

requiresSsl

Boolean

true jeśli plik cookie powinien być używany tylko za pośrednictwem połączenia SSL; w przeciwnym razie , false.

hideFromClientScript

Boolean

true jeśli plik cookie powinien być ukryty przed skryptem klienta; w przeciwnym razie , false.

context

HttpContext

Element HttpContext dla żądania.

Wyjątki

ArgumentNullException

value wartość jest pusta lub jest null pusta.

ArgumentException

name wartość jest pusta lub jest null pusta.