HttpWebRequest.Host 속성

정의

네임스페이스:

System.Net

어셈블리:

System.Net.Requests.dll

Source:

HttpWebRequest.cs

요청 URI와 독립적인 HTTP 요청에 사용할 Host 헤더 값을 가져오거나 설정합니다.

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 요청의 Host 헤더 값입니다.

예외

ArgumentNullException

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

ArgumentException

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

InvalidOperationException

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

설명

속성은 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를 기반으로 합니다.