HttpWebRequest.Host 속성

정의

네임스페이스:

System.Net

어셈블리:

System.Net.Requests.dll

Source:

HttpWebRequest.cs

요청 URI와 독립적으로 HTTP 요청에 사용할 호스트 헤더 값을 가져오거나 설정합니다.

public:
 property System::String ^ Host { System::String ^ get(); void set(System::String ^ value); };

public string Host { get; set; }

member this.Host : string with get, set

Public Property Host As String

속성 값

String

HTTP 요청의 호스트 헤더 값입니다.

예외

ArgumentNullException

호스트 헤더를 null설정할 수 없습니다.

ArgumentException

호스트 헤더를 잘못된 값으로 설정할 수 없습니다.

InvalidOperationException

HttpWebRequest 이미 전송되기 시작한 후에는 호스트 헤더를 설정할 수 없습니다.

설명

주의

WebRequest, HttpWebRequest, ServicePoint및 WebClient 사용되지 않으므로 새 개발에 사용하면 안 됩니다. 대신 HttpClient 사용합니다.

Host 속성을 사용하여 요청 URI와 독립적인 HTTP 요청에 사용할 호스트 헤더 값을 설정할 수 있습니다. Host 속성은 호스트 이름과 선택적 포트 번호로 구성됩니다. 포트 정보가 없는 호스트 헤더는 요청된 서비스의 기본 포트(예: HTTP URL의 경우 포트 80)를 의미합니다.

호스트 및 포트를 지정하는 형식은 IETF에서 게시한 RFC2616 섹션 14.23의 규칙을 따라야 합니다. 포트 8080을 지정하는 이러한 요구 사항을 준수하는 예제는 Host 속성에 대한 다음 값입니다.

www.contoso.com:8080

Host 속성을 사용하여 사용자 지정 호스트 헤더 값을 명시적으로 지정하면 영역 캐싱, 쿠키 및 인증에도 영향을 줍니다. 애플리케이션이 특정 URI 접두사에 대한 자격 증명을 제공하는 경우 애플리케이션은 URI의 대상 서버가 아닌 호스트 헤더 값이 포함된 URI를 사용해야 합니다. 리소스를 캐싱할 때 사용되는 키는 요청 URI 대신 호스트 헤더 값을 사용합니다. 쿠키는 CookieContainer 저장되고 서버 도메인 이름으로 논리적으로 그룹화됩니다. 애플리케이션에서 호스트 헤더를 지정하면 이 값이 도메인으로 사용됩니다.

Host 속성이 설정되지 않은 경우 HTTP 요청에 사용할 호스트 헤더 값은 요청 URI를 기반으로 합니다.