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 屬性。

如果 Date 屬性設定為 DateTime.MinValue，則會從 Headers 屬性和 WebHeaderCollection中移除 Date HTTP 標頭。

如果 Date 屬性是 DateTime.MinValue，這表示 Date HTTP 標頭不包含在 Headers 屬性和 WebHeaderCollection中。

注意

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