HttpWebRequest.Date 属性

定义

获取或设置要在 HTTP 请求中使用的 Date 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

属性值

HTTP 请求中的 Date 标头值。

注解

谨慎

WebRequestHttpWebRequestServicePointWebClient 已过时,不应将其用于新开发。 请改用 HttpClient

如果 Date 标头 null,则返回值将设置为 DateTime.MinValue

Date 属性是一个标准 System.DateTime 对象,可以包含 DateTimeKind.LocalDateTimeKind.UtcDateTimeKind.UnspecifiedSystem.DateTimeKind 字段。 使用 Date 属性时,可以设置任何类型的时间。 如果设置或检索 DateTimeKind.Unspecified,则假定 Date 属性 DateTimeKind.Local(本地时间)。

System.Net 命名空间中的类始终使用 GMT (Utc) 格式以标准形式在传输过程中将其写出网络上 Date 属性。

如果 Date 属性设置为 DateTime.MinValue,则会从 Headers 属性和 WebHeaderCollection中删除 Date HTTP 标头。

如果 Date 属性 DateTime.MinValue,则表示 Headers 属性和 WebHeaderCollection中不包含 Date HTTP 标头。

注意

此属性的值存储在 WebHeaderCollection中。 如果设置了 WebHeaderCollection,则属性值将丢失。

如果设置了 Date 并尝试发送没有正文的 HttpWebRequest,则 BeginGetResponseGetResponseEndGetResponse 方法将引发 System.Net.ProtocolViolationException

适用于