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 ヘッダー値。

注意

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

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

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

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

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

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

手記

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

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