語言

HttpWebRequest.Date 屬性

定義

取得或設定 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

屬性值

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為 ,表示 DateTime.MinValue HTTP 標頭未包含於該Date屬性中,且 HeadersWebHeaderCollection。

Note

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

若 已設定 並Date嘗試傳送無實體的 aHttpWebRequest,則 、 System.Net.ProtocolViolationException與 BeginGetResponse 方法會拋出 GetResponseaEndGetResponse。

適用於