HttpWebRequest.Date Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia wartość nagłówka HTTP Date
do użycia w żądaniu HTTP.
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
Wartość nagłówka Date w żądaniu HTTP.
Uwagi
Ostrożność
WebRequest
, HttpWebRequest
, ServicePoint
i WebClient
są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.
Jeśli nagłówek Date ma wartość null
, wartość zwracana zostanie ustawiona na wartość DateTime.MinValue.
Właściwość Date jest standardowym obiektem System.DateTime i może zawierać pole System.DateTimeKindDateTimeKind.Local, DateTimeKind.Utclub DateTimeKind.Unspecified. W przypadku używania właściwości Date można ustawić dowolny rodzaj czasu. Jeśli DateTimeKind.Unspecified jest ustawiona lub pobrana, przyjmuje się, że właściwość Date ma być DateTimeKind.Local (czas lokalny).
Klasy w przestrzeni nazw System.Net zawsze zapisują właściwość Date na przewodach podczas transmisji w postaci standardowej przy użyciu formatu GMT (Utc).
Jeśli właściwość Date jest ustawiona na DateTime.MinValue, nagłówek HTTP Date
zostanie usunięty z właściwości Headers i WebHeaderCollection.
Jeśli właściwość Date jest DateTime.MinValue, oznacza to, że nagłówek HTTP Date
nie jest uwzględniony we właściwości Headers i WebHeaderCollection.
Nuta
Wartość tej właściwości jest przechowywana w WebHeaderCollection. Jeśli parametr WebHeaderCollection jest ustawiony, wartość właściwości zostanie utracona.
Jeśli ustawiono Date i podjęto próbę wysłania HttpWebRequest bez treści, System.Net.ProtocolViolationException zostanie zgłoszony przez metody BeginGetResponse, GetResponsei EndGetResponse.