Freigeben über


HttpWebRequest.Date Eigenschaft

Definition

Ruft den HTTP-Headerwert ab, der Date in einer HTTP-Anforderung verwendet werden soll, oder legt diesen 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

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 Datumskopfzeile lautet null, wird der Rückgabewert auf DateTime.MinValue.

Die Date Eigenschaft ist ein Standardobjekt System.DateTime und kann ein System.DateTimeKind Feld von DateTimeKind.Local, , DateTimeKind.Utcoder DateTimeKind.Unspecified. Bei Verwendung der Date Eigenschaft kann jede 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 sie immer aus der Date Eigenschaft auf dem Draht während der Übertragung in Standardform mithilfe des GMT(Utc)-Formats.

Wenn die Date Eigenschaft auf DateTime.MinValue festgelegt ist, wird der Date HTTP-Header aus der Headers Eigenschaft und der WebHeaderCollectionEigenschaft entfernt.

Wenn die Eigenschaft lautetDateTime.MinValue, gibt dies Date an, dass der Date HTTP-Header nicht in der Headers Eigenschaft und der WebHeaderCollection.

Anmerkung

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

Wenn der Date Wert festgelegt ist und versucht wird, einen HttpWebRequest Text ohne Textkörper zu senden, wird ein System.Net.ProtocolViolationException Fehler durch die BeginGetResponseMethoden GetResponseund Methoden EndGetResponse ausgelöst.

Gilt für: