HttpWebRequest.Date Eigenschaft

Definition

Ruft den Date-HTTP-Headerwert für eine HTTP-Anforderung ab oder legt ihn fest.Gets or sets the Date HTTP header value to use in an HTTP request.

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 Datumsheaderwert in der HTTP-Anforderung.The Date header value in the HTTP request.

Hinweise

Wenn der Date-Header nullist, wird der Rückgabewert auf DateTime.MinValuefestgelegt.If the Date header is null, then the return value will be set to DateTime.MinValue.

Die Date-Eigenschaft ist ein Standard System.DateTime Objekt und kann ein System.DateTimeKind Feld mit DateTimeKind.Local, DateTimeKind.Utcoder DateTimeKind.Unspecifiedenthalten.The Date property is a standard System.DateTime object and can contain a System.DateTimeKind field of DateTimeKind.Local, DateTimeKind.Utc, or DateTimeKind.Unspecified. Jede Art von Zeit kann festgelegt werden, wenn die Date-Eigenschaft verwendet wird.Any kind of time can be set when using the Date property. Wenn DateTimeKind.Unspecified festgelegt oder abgerufen wird, wird davon ausgegangen, dass die Eigenschaft Date DateTimeKind.Local (Ortszeit) ist.If DateTimeKind.Unspecified is set or retrieved, the Date property is assumed to be DateTimeKind.Local (local time).

Die Klassen im System.Net-Namespace schreiben Date Sie immer bei der Übertragung während der Übertragung in Standardform im GMT (UTC)-Format.The classes in the System.Net namespace always write it out the Date property on the wire during transmission in standard form using GMT (Utc) format.

Wenn die Date-Eigenschaft auf DateTime.MinValuefestgelegt ist, wird der Date-HTTP-Header aus der Headers-Eigenschaft und der WebHeaderCollectionentfernt.If the Date property is set to DateTime.MinValue, then the Date HTTP header is removed from the Headers property and the WebHeaderCollection.

Wenn die Date-Eigenschaft DateTime.MinValueist, bedeutet dies, dass der Date-HTTP-Header nicht in der Headers-Eigenschaft und WebHeaderCollectionenthalten ist.If the Date property is DateTime.MinValue, this indicates that the Date HTTP header is not included in the Headers property and the WebHeaderCollection.

Hinweis

Der Wert für diese Eigenschaft wird in der WebHeaderCollection gespeichert.The value for this property is stored in WebHeaderCollection. Wenn WebHeaderCollection festgelegt wird, geht der Eigenschaftswert verloren.If WebHeaderCollection is set, the property value is lost.

Wenn die Date festgelegt ist und versucht wird, eine HttpWebRequest ohne Text zu senden, wird eine System.Net.ProtocolViolationException von den Methoden BeginGetResponse, GetResponseund EndGetResponse ausgelöst.If the Date is set and an attempt is made to send a HttpWebRequest with no body, then a System.Net.ProtocolViolationException will be thrown by the BeginGetResponse, GetResponse, and EndGetResponse methods.

Gilt für: