HttpWebRequest.Date Właściwość

Definicja

Pobiera lub ustawia wartość nagłówka HTTP Date, która będzie używana w żądaniu HTTP.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

Wartość właściwości

DateTime

Wartość nagłówka daty w żądaniu HTTP.The Date header value in the HTTP request.

Uwagi

Jeśli nagłówek daty jest null, wartość zwracana zostanie ustawiona na DateTime.MinValue.If the Date header is null, then the return value will be set to DateTime.MinValue.

Właściwość Date jest obiektem System.DateTime standardowego i może zawierać System.DateTimeKind pole DateTimeKind.Local, DateTimeKind.Utclub DateTimeKind.Unspecified.The Date property is a standard System.DateTime object and can contain a System.DateTimeKind field of DateTimeKind.Local, DateTimeKind.Utc, or DateTimeKind.Unspecified. Dowolny rodzaj czasu można ustawić przy użyciu właściwości Date.Any kind of time can be set when using the Date property. Jeśli DateTimeKind.Unspecified jest ustawiona lub pobierana, przyjmuje się, że właściwość Date zostanie DateTimeKind.Local (czas lokalny).If DateTimeKind.Unspecified is set or retrieved, the Date property is assumed to be DateTimeKind.Local (local time).

Klasy w przestrzeni nazw System.Net zawsze zapisują Właściwość Date w sieci podczas transmisji w standardowym formacie przy użyciu formatu GMT (UTC).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.

Jeśli właściwość Date jest ustawiona na DateTime.MinValue, nagłówek Date HTTP zostanie usunięty z właściwości Headers i WebHeaderCollection.If the Date property is set to DateTime.MinValue, then the Date HTTP header is removed from the Headers property and the WebHeaderCollection.

Jeśli właściwość Date jest DateTime.MinValue, oznacza to, że nagłówek Date HTTP nie jest uwzględniony we właściwości Headers i WebHeaderCollection.If the Date property is DateTime.MinValue, this indicates that the Date HTTP header is not included in the Headers property and the WebHeaderCollection.

Uwaga

Wartość tej właściwości jest przechowywana w WebHeaderCollection.The value for this property is stored in WebHeaderCollection. Jeśli jest ustawiona właściwość WebHeaderCollection, wartość właściwości zostanie utracona.If WebHeaderCollection is set, the property value is lost.

Jeśli ustawiono Date i podjęto próbę wysłania HttpWebRequest bez treści, System.Net.ProtocolViolationException będą zgłaszane metody BeginGetResponse, GetResponsei EndGetResponse.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.

Dotyczy