HttpWebRequest.Date Property

Definition

Obtient ou définit la valeur d’en-tête HTTP Date à utiliser dans une requête 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

Property Value

DateTime

Valeur d'en-tête Date dans la requête HTTP.The Date header value in the HTTP request.

Remarks

Si l’en-tête de date est null, la valeur de retour est définie sur DateTime.MinValue.If the Date header is null, then the return value will be set to DateTime.MinValue.

La propriété Date est un objet System.DateTime standard et peut contenir un champ System.DateTimeKind de DateTimeKind.Local, DateTimeKind.Utcou 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. Tout type de temps peut être défini lors de l’utilisation de la propriété Date.Any kind of time can be set when using the Date property. Si DateTimeKind.Unspecified est définie ou récupérée, la propriété Date est supposée être DateTimeKind.Local (heure locale).If DateTimeKind.Unspecified is set or retrieved, the Date property is assumed to be DateTimeKind.Local (local time).

Les classes de l’espace de noms System.Net écrivent toujours la propriété Date sur le câble pendant la transmission sous forme standard au format 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.

Si la propriété Date est définie sur DateTime.MinValue, l’en-tête HTTP Date est supprimé de la propriété Headers et du WebHeaderCollection.If the Date property is set to DateTime.MinValue, then the Date HTTP header is removed from the Headers property and the WebHeaderCollection.

Si la propriété Date est DateTime.MinValue, cela indique que l’en-tête HTTP Date n’est pas inclus dans la propriété Headers et le 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.

Note

La valeur de cette propriété est stockée dans WebHeaderCollection.The value for this property is stored in WebHeaderCollection. Si WebHeaderCollection est défini, la valeur de la propriété est perdue.If WebHeaderCollection is set, the property value is lost.

Si la Date est définie et qu’une tentative d’envoi d’un HttpWebRequest sans corps est effectuée, une System.Net.ProtocolViolationException est levée par les méthodes BeginGetResponse, GetResponseet 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.

Applies to