Application.SetCookie(Uri, String) Application.SetCookie(Uri, String) Application.SetCookie(Uri, String) Method

Определение

Создает файл cookie для расположения, указанного Uri.Creates a cookie for the location specified by a Uri.

public:
 static void SetCookie(Uri ^ uri, System::String ^ value);
public static void SetCookie (Uri uri, string value);
static member SetCookie : Uri * string -> unit

Параметры

uri
Uri Uri Uri

Uri, определяющий положение, для которого следует создать файл cookie.The Uri that specifies the location for which the cookie should be created.

value
String String String

String, содержащий данные о файле cookie.The String that contains the cookie data.

Исключения

Если при попытке создать указанный файл cookie возникла проблема, функция InternetSetCookie (вызванная SetCookie(Uri, String)) генерирует ошибку Win32Win32.A Win32Win32 error is raised by the InternetSetCookie function (called by SetCookie(Uri, String)) if a problem occurs when attempting to create the specified cookie.

Комментарии

Файл cookie — это произвольная часть данных, которая может храниться в приложении на клиентском компьютере во время сеансов приложения (файлы cookie сеансов) или в сеансах приложения (постоянные файлы cookie).A cookie is an arbitrary piece of data that can be stored by an application on the client machine during application sessions (session cookies) or across application sessions (persistent cookies). Можно создать оба типа файлов cookie, вызвав SetCookie.You can create both types of cookies by calling SetCookie.

Данные файлов cookie обычно принимают форму пары "имя-значение" в следующем формате:Cookie data typically takes the form of a name/value pair in the following format:

Name=Value

Вы передаете строку этого формата SetCookieвместе Uri с расположением, для которого должен быть задан файл cookie (обычно это домен приложения).You pass a string of this format to SetCookie, along with the Uri of the location for which the cookie should be set (typically, the application domain).

Является ли файл cookie файлом cookie сеанса или сохраняемым файлом cookie, зависит от того, SetCookie содержит ли строка файла cookie, которую вы передаете, дату окончания срока действия.Whether a cookie is a session cookie or a persistent cookie depends on whether the cookie string that you pass to SetCookie includes an expiry date. Строка для файла cookie сеанса не содержит дату окончания срока действия.The string for a session cookie does not include an expiry date. Строка для постоянного файла cookie имеет значение и должно иметь следующий формат:The string for a persistent cookie does, and must be in the following format:

NAME=VALUE; expires=DAY, DD-MMM-YYYY HH:MM:SS GMT

Постоянные файлы cookie хранятся в папке Temporary WindowsWindows Internet Files текущей установки до истечения срока действия, в этом случае они удаляются.Persistent cookies are stored in the current WindowsWindows installation's Temporary Internet Files folder until they expire, in which case they are deleted. Вы можете удалить постоянный файл cookie из приложения, указав для его даты окончания срока действия значение даты и времени в прошлом.You can delete a persistent cookie from your application by setting its expiry date to a date/time value that is in the past.

Общие сведения о файлах cookie в WPFWPFсм. в разделе Общие сведения о навигации.For an overview of cookies in WPFWPF, see Navigation Overview.

Безопасность

FileIOPermission
для получения файла cookie для файлов Uri.for getting the cookie for a file-based Uri. Связанное перечисление:ReadAssociated enumeration: Read

WebPermission
для получения файла cookie для не основанного на Uriфайлах.for getting the cookie for a non-file-based Uri. Связанное перечисление:ConnectAssociated enumeration: Connect

Применяется к

Дополнительно