HttpWebRequest.Date Eigenschaft

Definition

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Source:

HttpWebRequest.cs

Ruft den Date-HTTP-Headerwert für eine HTTP-Anforderung ab oder legt ihn fest.

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

Eigenschaftswert

DateTime

Der Datumsheaderwert in der HTTP-Anforderung.

Hinweise

Wenn der Date-Header ist null, wird der Rückgabewert auf DateTime.MinValuefestgelegt.

Die Date -Eigenschaft ist ein Standardobjekt System.DateTime und kann ein System.DateTimeKind Feld von DateTimeKind.Local, DateTimeKind.Utcoder DateTimeKind.Unspecifiedenthalten. Bei Verwendung der Date -Eigenschaft kann eine beliebige Art von Zeit festgelegt werden. Wenn DateTimeKind.Unspecified festgelegt oder abgerufen wird, wird die Date Eigenschaft als (Ortszeit) angenommen DateTimeKind.Local .

Die Klassen im System.Net Namespace schreiben während der Übertragung im GMT-Format (Utc) immer die Date -Eigenschaft auf der Leitung aus.

Wenn die Date -Eigenschaft auf DateTime.MinValuefestgelegt ist, wird der Date HTTP-Header aus der Headers -Eigenschaft und der WebHeaderCollectionentfernt.

Wenn die Date -Eigenschaft ist DateTime.MinValue, gibt dies an, dass der Date HTTP-Header nicht in der Headers -Eigenschaft und dem WebHeaderCollectionenthalten ist.

Hinweis

Der Wert für diese Eigenschaft wird in der WebHeaderCollection gespeichert. Wenn WebHeaderCollection festgelegt wird, geht der Eigenschaftswert verloren.

Wenn festgelegt Date ist und versucht wird, ein HttpWebRequest mit keinem Textkörper zu senden, wird ein System.Net.ProtocolViolationException von den BeginGetResponseMethoden , GetResponseund EndGetResponse ausgelöst.