HttpWebRequest.Date プロパティ

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

HTTP 要求で使用する Date HTTP ヘッダー値を取得または設定します。

public:
 property DateTime Date { DateTime get(); void set(DateTime value); };

public DateTime Date { get; set; }

member this.Date : DateTime with get, set

Public Property Date As DateTime

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

Date ヘッダーがの null場合、戻り値はに DateTime.MinValue設定されます。

プロパティはDate標準オブジェクトであり、または DateTimeKind.UnspecifiedのDateTimeKind.Local DateTimeKind.UtcフィールドをSystem.DateTimeKind含System.DateTimeめることができます。プロパティを使用する場合は、任意の種類の時間を Date 設定できます。が設定または取得された場合 DateTimeKind.Unspecified 、 Date プロパティは (ローカル時刻) であると見なされます DateTimeKind.Local 。

名前空間の System.Net クラスは、GMT (Utc) 形式を Date 使用して標準形式で送信中に、常にネットワーク上のプロパティを書き出します。

プロパティが Date にDateTime.MinValueDate設定されている場合、HTTP ヘッダーはプロパティと WebHeaderCollectionからHeaders削除されます。

プロパティが Date の場合、DateTime.MinValueHTTP ヘッダーがプロパティとにHeaders含まれていないことをDate示しますWebHeaderCollection。

注意

このプロパティの値は WebHeaderCollection に格納されます。 WebHeaderCollection が設定されている場合、プロパティ値は失われます。

Dateが設定され、本文なしでをHttpWebRequest送信しようとすると、 System.Net.ProtocolViolationException メソッド、、および EndGetResponse メソッドによって BeginGetResponse GetResponseがスローされます。