HttpWebRequest.Date Eigenschaft

Definition

Dient zum Abrufen oder Festlegen des Date HTTP-Headerwerts, der in einer HTTP-Anforderung verwendet werden soll.

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

Der Wert des Date-Headers in der HTTP-Anforderung.

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Wenn die Datumsüberschrift nullist, wird der Rückgabewert auf DateTime.MinValuefestgelegt.

Die Date-Eigenschaft ist ein Standardobjekt System.DateTime und kann ein System.DateTimeKind Feld mit DateTimeKind.Local, DateTimeKind.Utcoder DateTimeKind.Unspecifiedenthalten. Bei Verwendung der Date-Eigenschaft kann jede Art von Zeit festgelegt werden. Wenn DateTimeKind.Unspecified festgelegt oder abgerufen wird, wird davon ausgegangen, dass die Date-Eigenschaft DateTimeKind.Local (Ortszeit) ist.

Die Klassen im System.Net Namespace schreiben es immer aus der Date-Eigenschaft auf dem Draht während der Übertragung in Standardform mit GMT (Utc)-Format.

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

Wenn die eigenschaft DateDateTime.MinValueist, gibt dies an, dass der Date HTTP-Header nicht in der eigenschaft Headers und der WebHeaderCollectionenthalten ist.

Anmerkung

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

Wenn die Date festgelegt ist und versucht wird, eine HttpWebRequest ohne Textkörper zu senden, wird ein System.Net.ProtocolViolationException durch die Methoden BeginGetResponse, GetResponseund EndGetResponse ausgelöst.

Gilt für: