HttpHeaders.Add 메서드

정의

네임스페이스:

System.Net.Http.Headers

어셈블리:

System.Net.Http.dll

새 헤더와 해당 값을 HttpHeaders 컬렉션에 삽입합니다.

오버로드

Add(String, IEnumerable<String>)	지정된 헤더와 해당 값을 HttpHeaders 컬렉션에 추가합니다.
Add(String, String)	지정된 헤더와 해당 값을 HttpHeaders 컬렉션에 추가합니다.

Add(String, IEnumerable<String>)

Source:

HttpHeaders.cs

지정된 헤더와 해당 값을 HttpHeaders 컬렉션에 추가합니다.

public:
 void Add(System::String ^ name, System::Collections::Generic::IEnumerable<System::String ^> ^ values);

public void Add (string name, System.Collections.Generic.IEnumerable<string?> values);

member this.Add : string * seq<string> -> unit

Public Sub Add (name As String, values As IEnumerable(Of String))

매개 변수

name

String

컬렉션에 추가할 헤더입니다.

values

IEnumerable<String>

컬렉션에 추가할 헤더 값 목록입니다.

예외

ArgumentException

이름은 null이거나 비워 둘 수 없습니다.

ArgumentNullException

값은 null이거나 비워 둘 수 없습니다.

InvalidOperationException

오용된 헤더 이름입니다. 요청 헤더가 HttpRequestMessage, HttpResponseMessage가 있는 응답 헤더 및 HttpContent 개체가 있는 콘텐츠 헤더와 함께 사용되는지 확인합니다.

FormatException

헤더 이름 형식이 잘못되었습니다.

-또는-

헤더 값 형식이 이 헤더 이름에 유효하지 않거나 헤더가 여러 값을 지원하지 않습니다.

설명

헤더 이름은 유효한 HTTP 토큰으로 적용됩니다. 여기서 토큰은 "!#$%&'*+-.^_`|~" 집합의 ASCII 문자, 숫자 또는 기호 집합으로 정의되고 RFC9110정의와 일치합니다. 헤더 이름에는 ASCII가 아닌 문자가 허용되지 않습니다.

헤더 values 구문 분석되고 유효성이 검사됩니다.

지정된 헤더가 없으면 Add 메서드는 헤더 이름/값 쌍 목록에 새 헤더를 삽입합니다.

지정된 헤더가 이미 있는 경우 values 헤더와 연결된 값의 쉼표로 구분된 목록에 추가됩니다.

Add(String, String)

Source:

HttpHeaders.cs

지정된 헤더와 해당 값을 HttpHeaders 컬렉션에 추가합니다.

public:
 void Add(System::String ^ name, System::String ^ value);

public void Add (string name, string? value);

member this.Add : string * string -> unit

Public Sub Add (name As String, value As String)

매개 변수

name

String

컬렉션에 추가할 헤더입니다.

value

String

헤더의 내용입니다.

예외

ArgumentException

이름은 null이거나 비워 둘 수 없습니다.

InvalidOperationException

오용된 헤더 이름입니다. 요청 헤더가 HttpRequestMessage, HttpResponseMessage가 있는 응답 헤더 및 HttpContent 개체가 있는 콘텐츠 헤더와 함께 사용되는지 확인합니다.

FormatException

헤더 이름 형식이 잘못되었습니다.

-또는-

헤더 값 형식이 이 헤더 이름에 유효하지 않거나 헤더가 여러 값을 지원하지 않습니다.

설명

헤더 이름은 유효한 HTTP 토큰으로 적용됩니다. 여기서 토큰은 "!#$%&'*+-.^_`|~" 집합의 ASCII 문자, 숫자 또는 기호 집합으로 정의되고 RFC9110정의와 일치합니다. 헤더 이름에는 ASCII가 아닌 문자가 허용되지 않습니다.

헤더 values 구문 분석되고 유효성이 검사됩니다.

지정된 헤더가 없으면 Add 메서드는 헤더 이름/값 쌍 목록에 새 헤더를 삽입합니다.

지정된 헤더가 이미 있는 경우 value 헤더와 연결된 쉼표로 구분된 값 목록에 추가됩니다.