Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

HttpWebRequest.Date Property

Get or set the Date HTTP header value to use in an HTTP request.

Namespace:  System.Net
Assembly:  System (in System.dll)
'Declaration
Public Property Date As DateTime

Property Value

Type: System.DateTime
The Date header value in the HTTP request.

If the Date header is Nothing, then the return value will be set to DateTime.MinValue.

The Date property is a standard System.DateTime object and can contain a System.DateTimeKind field of DateTimeKind.Local, DateTimeKind.Utc, or DateTimeKind.Unspecified. Any kind of time can be set when using the Date property. If DateTimeKind.Unspecified is set or retrieved, the Date property is assumed to be DateTimeKind.Local (local time).

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.

If the Date property is set to DateTime.MinValue, then the Date HTTP header is removed from the Headers property and the 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.

NoteNote

The value for this property is stored in WebHeaderCollection. If WebHeaderCollection is set, the property value is lost.

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.

.NET Framework

Supported in: 4.5.1, 4.5, 4

.NET Framework Client Profile

Supported in: 4

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.