WebHeaderCollection.AddWithoutValidate(String, String) 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將標頭插入至集合，不檢查標頭是否在受限制標頭清單上。

protected:
 void AddWithoutValidate(System::String ^ headerName, System::String ^ headerValue);

protected void AddWithoutValidate (string headerName, string? headerValue);

protected void AddWithoutValidate (string headerName, string headerValue);

member this.AddWithoutValidate : string * string -> unit

Protected Sub AddWithoutValidate (headerName As String, headerValue As String)

要加入至集合的標頭。

標頭的內容。

headerName 是 null、Empty 或含有無效字元。

-或-

headerValue 包含無效的字元。

僅限 .NET Framework 與 .NET Core：headerName 不是 null，且 headerValue 的長度太長 (大於 65,535 個字元)。

方法 AddWithoutValidate 會將標頭新增至集合，而不檢查標頭是否位於受限制的標頭清單上。

注意

的 headerValue 長度只會在 .NET Framework 和 .NET Core 2.0 - 3.1 版中驗證。

在所有適用的 .NET Framework 版本上：WebHeaderCollection如果的headerValue長度大於 65535，屬性所Headers傳回的實例將會擲ArgumentOutOfRangeException回。所有其他 WebHeaderCollection 實體都接受 headerValue 任何長度的。
在 .NET Core 版本到 3.1 版：WebHeaderCollection如果的長度headerValue大於 65535，則搭配類型HttpResponseHeader之任何標頭使用的實例會擲回 ArgumentOutOfRangeException 。所有其他 WebHeaderCollection 實體都接受 headerValue 任何長度的。
在 .NET 5 和更新版本上： WebHeaderCollection 接受 headerValue 任何長度的。

AddWithoutValidate(String, String)使用方法來新增通常會透過屬性公開的標頭。