版本:Unity 6 (6000.0)
语言英语
  • C#

UnityWebRequest.SetRequestHeader

提出更改建议

成功!

感谢您帮助我们提高 Unity 文档的质量。尽管无法接受所有提交文档,但我们会阅读用户提出的每一条更改建议,并在适用时进行更新。

关闭

提交失败

由于某种原因,未能提交您建议的更改。请在几分钟后<a>重试</a>。感谢您花时间帮助我们提高 Unity 文档质量。

关闭

取消

声明

public void SetRequestHeader(string name, string value);

参数

name 待设置的标题的键。区分大小写。
value 标题的预期值。

描述

将 HTTP 请求标题设置为自定义值。

标题键和值必须按照 HTTP 协议规范有效。两个字符串均不得包含某些非法字符,如控制字符。两个字符串均不得为 null,且至少包含 1 个字符。有关详细信息,请参阅 HTTP 规范

在调用 SendWebRequest 后,无法调用此方法。

不建议将这些标题设置为这些自定义值:Accept-CharsetAccept-EncodingAccess-Control-Request-HeadersAccess-Control-Request-MethodConnectionDateDntExpectHostKeep-AliveOriginRefererTeTrailerTransfer-EncodingUpgradeVia。由于跨平台的各种限制,自定义值可能会被覆盖、忽略或不受支持,因此产生的行为可能不可靠。强烈建议保留对这些标题的自动处理,除非您希望查看任何意外的结果。

Accept-Encoding 标题会自动设置为受支持的编码。使用其他值会被忽略,或者可能导致请求失败。有关详细信息,请参阅有关接受编码的 [Mozilla 文档](https://mdn.org.cn/en-US/docs/Web/HTTP/Headers/Accept-Encoding)。

如果存在附加 DownloadHandlerContent-Length 标题会自动根据其内容填充,并且无法设置为自定义值。

X-Unity-Version 标头是由 Unity 自动设置的,可能不会设置为自定义值。

User-Agent 标头是由 Unity 自动设置的,不建议将其设置为自定义值。

CookieCookie2 标头由底层的 Cookie 引擎自动管理。虽然具体行为取决于所使用的平台,但通常情况下,通过此标头设置 Cookie 会将它们添加到由引擎设置的 Cookie 中。更多资源:ClearCookieCache

此外,在 Web 平台上,以下标头由 Web 浏览器填充,因此可能没有任何设置的自定义值:CookieCookie2User-Agent