HttpWebRequest.Host プロパティ

定義

名前空間:

System.Net

アセンブリ:

System.Net.Requests.dll

ソース:

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 要求の Host ヘッダー値。

例外

ArgumentNullException

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

ArgumentException

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

InvalidOperationException

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

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。 代わりに HttpClient を使用してください。

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

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

www.contoso.com:8080

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

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