Admin: 1 revision imported

2021-02-07T06:51:23Z

1 revision imported

Admin at 07:26, 24 April 2020

2020-04-24T07:26:46Z

New page

{{infobox function
|name=HTTPSetCookie
|object=[[Объект IP]]
|caption=Работа с HTTP
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект IP]]}}
Функция позволяет добавить информацию в поле заголовка <code>Cookie</code>. Функция обычно используется при формировании запроса на сервер для передачи сохраненных ранее переменных cookie. При использовании объекта cookie, нужный массив переменных можно загрузить в заголовок функцией [[IPConnection.Cookie.CopyToHeader|CopyToHeader]]. Если переменная cookie уже существует в заголовке, данная функция заменяет ее значение. При отсутствии второго аргумента, переменная будет удалена из поля ''Cookie''. Важно понимать, что функция работает для HTTP пакетов клиента и передает переменные cookie, которые были получены в пакете от сервера в полях заголовка <code>Set-Cookie</code>, сервер мог передать несколько таких полей, поле <code>Cookie</code> всегда одно в заголовке и содержит все переменные cookie в одном значении. Поле имеет следующий формат: <code>Cookie: <Имя переменной 1>=<Значение переменной 1>[; <Имя переменной 2>=<Значение переменной 2>...]</code>. Поэтому значение переменных cookie должны содержать только ASCII символы (ограничение формата заголовка HTTP пакетов), не должны содержать символов с кодами <32, и не должны содержать следующие символы: ''';''', ''',''', '''"''', '''\''' и '''пробел''' (знак '''=''' разрешен).

== Синтаксис ==
<code>
{{Grey|IPConnection.}}'''HTTPSetCookie'''(''<Наименование cookie (STRING)>''{{Optional|,<Значение cookie (STRING)>}})
</code>

==== Аргументы ====
* <code>''<Наименование cookie (STRING)>''</code> - ANSI строка с наименованием переменной cookie. Наименования записываются с учетом регистра. <code>AAAAA</code> и <code>aaaaa</code> это два разных наименования, задающие разные переменные.
* <code>''<Значение cookie (STRING)>''</code> - ANSI строка со значением переменной. Если аргумент отсутствует, переменная будет удалена.

== Примеры ==
<pre>
...
Сессия:=ГенерацияНомераСессии();
TCP.HTTPClear(3);
TCP.HTTPSetOperation("HTTP/1.0 200 OK");
TCP.HTTPSetHeaderField("Date",FormatDate(аДата,"N, DD M YYYY hh:tt:ss ""GMT""","en"));
TCP.HTTPSetHeaderField("Server","SF http server");
TCP.HTTPSetHeaderField("Last-Modified",FormatDate(аДата,"N, DD M YYYY hh:tt:ss ""GMT""","en"));
TCP.HTTPSetHeaderField("Cache-Control","no-store");
TCP.HTTPSetHeaderField("Connection","close");
TCP.HTTPSetCookie("session",Сессия);
TCP.HTTPSend();
</pre>

← Older revision	Revision as of 06:51, 7 February 2021
(No difference)

IPConnection.HTTPSetCookie - Revision history

Admin: 1 revision imported

Admin at 07:26, 24 April 2020