UnityWebRequest.SetRequestHeader
Declaration
public void SetRequestHeader(string name, string value);Параметры
| Параметр | Описание |
|---|---|
| имя | Ключ заголовка для установки. |
| значение | Предполагаемое значение заголовка. |
Описание
Устанавливает заголовок запроса HTTP в пользовательское значение.
Ключи и значения заголовков должны соответствовать спецификации протокола HTTP. Ни одна из строк не может содержать недопустимые символы, например управляющие. Обе строки должны быть ненулевыми и содержать не менее одного символа. Дополнительные сведения см. в спецификациях HTTP.
Этот метод нельзя вызывать после вызова SendWebRequest.
Не рекомендуется задавать пользовательские значения для следующих заголовков: Accept-Charset, Accept-Encoding, Access-Control-Request-Headers, Access-Control-Request-Method, Connection, Date, Dnt, Expect, Host, Keep-Alive, Origin, Referer, Te, Trailer, Transfer-Encoding, Upgrade, Via. Из-за различий в ограничениях платформ пользовательское значение может быть переопределено, проигнорировано или не поддерживаться, поэтому итоговое поведение ненадёжно. Настоятельно рекомендуется оставить автоматическую обработку этих заголовков, если вы не готовы к непредвиденным результатам.
Для заголовка Accept-Encoding автоматически задаются поддерживаемые кодировки. Другое значение игнорируется или может привести к сбою запроса. Дополнительные сведения об Accept-Encoding см. в [документации Mozilla](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Encoding).
Заголовок Content-Length автоматически заполняется на основе содержимого прикреплённого объекта DownloadHandler, если он есть; задать пользовательское значение нельзя.
Заголовок X-Unity-Version автоматически задаётся Unity, и задать для него пользовательское значение невозможно.
Заголовок User-Agent автоматически задаётся Unity; задавать для него пользовательское значение не рекомендуется.
Заголовки Cookie и Cookie2 автоматически обрабатываются внутренним механизмом cookie. Точное поведение зависит от платформы, но обычно cookie, заданные через этот заголовок, добавляются к установленным механизмом. Дополнительные ресурсы: ClearCookieCache.
Кроме того, в браузере на платформе Веб следующие заголовки заполняются автоматически, поэтому для них нельзя задать пользовательские значения: Cookie, Cookie2, User-Agent.