HttpWebRequest.Host プロパティ

定義

要求 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

プロパティ値

HTTP 要求の Host ヘッダーの値。

例外

Host ヘッダーを null に設定することはできません。

ホスト ヘッダーを無効な値には設定できません。

Host ヘッダーは、HttpWebRequest の送信が既に開始された後には設定できません。

注釈

プロパティを Host 使用して、要求 URI から独立した HTTP 要求で使用する Host ヘッダー値を設定できます。 プロパティは Host 、ホスト名とオプションのポート番号で構成できます。 ポート情報のないホスト ヘッダーは、要求されたサービスの既定のポート (HTTP URL の場合はポート 80 など) を意味します。

ホストとポートを指定する形式は、IETF によって発行された RFC2616 のセクション 14.23 の規則に従う必要があります。 ポート 8080 を指定するこれらの要件に準拠する例は、 プロパティの次の値 Host です。

www.contoso.com:8080

プロパティを Host 使用してカスタム ホスト ヘッダー値を明示的に指定すると、領域のキャッシュ、Cookie、認証にも影響します。 アプリケーションが特定の URI プレフィックスの資格情報を提供する場合、アプリケーションでは、URI 内のターゲット サーバーではなく、ホスト ヘッダーの値を含む URI を必ず使用する必要があります。 リソースのキャッシュ時に使用されるキーは、要求 URI ではなく Host ヘッダー値を使用します。 Cookie は に CookieContainer 格納され、サーバー ドメイン名によって論理的にグループ化されます。 アプリケーションで Host ヘッダーが指定されている場合、この値はドメインとして使用されます。

プロパティが Host 設定されていない場合、HTTP 要求で使用する Host ヘッダー値は要求 URI に基づきます。

適用対象