HttpWebRequest.Host プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
要求 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 に基づきます。
適用対象
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示