HttpWebRequest.Date Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
, ServicePoint
und WebClient
sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.
Wenn die Datumsüberschrift null
ist, 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.