HttpWebRequest.Date 屬性

定義

命名空間:

System.Net

組件:

netstandard.dll, System.Net.Requests.dll

來源:

HttpWebRequest.cs

取得或設定 Date HTTP 標頭值用於 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

屬性值

DateTime

HTTP 要求中的Date標頭值。

備註

謹慎

WebRequest、、HttpWebRequest、ServicePointWebClient、和 都已過時，你不應該用它們來做新開發。 請改用 HttpClient。

若日期標頭為 null，則回傳值將設為 DateTime.MinValue。

屬性 Date 是一個標準 System.DateTime 物件，可以包含 System.DateTimeKind 一個欄位 DateTimeKind.Local、 DateTimeKind.Utc、 或 DateTimeKind.Unspecified。 使用該 Date 物業時，任何時間都可以設定。 若 DateTimeKind.Unspecified 被設定或檢索， Date 則假設性質為 DateTimeKind.Local （局部時間）。

命名空間中的 System.Net 類別在傳輸過程中，總是以標準形式使用 GMT（UTC）格式寫 Date 出該屬性。

若 Date 屬性設為 DateTime.MinValue，則 Date HTTP 標頭會從 Headers 屬性中移除，且 WebHeaderCollection。

若屬性Date為 ，表示 Date HTTP 標頭未包含於該Headers屬性中，且 WebHeaderCollectionDateTime.MinValue。

注意

此屬性的值儲存在 WebHeaderCollection。 如果已設定 WebHeaderCollection，屬性值就會遺失。

若 已設定 並Date嘗試傳送無實體的 aHttpWebRequest，則 、 GetResponse與 EndGetResponse 方法會拋出 BeginGetResponseaSystem.Net.ProtocolViolationException。