HttpRequestHeaderCollection.IfUnmodifiedSince 属性

定义

命名空间:

Windows.Web.Http.Headers

获取或设置 DateTime 对象，该对象代表 HTTP 请求上的 If-Unmodified-Since HTTP 标头的值。

public:
 property IReference<DateTime> ^ IfUnmodifiedSince { IReference<DateTime> ^ get(); void set(IReference<DateTime> ^ value); };

IReference<DateTime> IfUnmodifiedSince();

void IfUnmodifiedSince(IReference<DateTime> value);

public System.Nullable<System.DateTimeOffset> IfUnmodifiedSince { get; set; }

var iReference = httpRequestHeaderCollection.ifUnmodifiedSince;
httpRequestHeaderCollection.ifUnmodifiedSince = iReference;

Public Property IfUnmodifiedSince As Nullable(Of DateTimeOffset)

属性值

IReference<DateTime>

Nullable<DateTimeOffset>

表示 HTTP 请求上 If-Unmodified-Since HTTP 标头的值的 DateTime 对象。 null 值表示标头不存在。

注解

IfUnmodifiedSince 属性表示 HTTP 请求消息上的 If-Unmodified-Since HTTP 标头的值。 If-Unmodified-Since 标头是自那以后未修改内容的日期和时间。

Javascript 和 .NET 语言不直接使用 DateTime 对象。 在 Javascript 中， DateTime 投影为对象，在 .NET 中，它投影为 System.DateTimeOffset。 每种语言以透明方式处理相应语言的粒度和日期范围的转换。

在 C++ 中，值具有与 相同的粒度，并支持 Javascript 和 .NET 所需的日期范围。

有关更多详细信息，请参阅 Windows.Foundation.DateTime 结构。

以下示例代码演示了一个方法，该方法使用 HttpRequestHeaderCollection 对象的 IfUnmodifiedSince 属性在 HttpRequestMessage 对象上设置 If-Unmodified-Since 标头。

public void DemonstrateHeaderRequestIfUnmodifiedSince() {
    var request = new HttpRequestMessage();

    // This is not typically set with a string.

    // Set the header with a strong type.
    var value = DateTimeOffset.Now.AddDays(-1); // Since yesterday.
    request.Headers.IfUnmodifiedSince = value;

    // Get the strong type out
    System.Diagnostics.Debug.WriteLine("IfUnmodifiedSince value in ticks: {0}", request.Headers.IfUnmodifiedSince.Value.Ticks);

    // The ToString() is useful for diagnostics, too.
    System.Diagnostics.Debug.WriteLine("The IfUnmodfiedSince ToString() results: {0}", request.Headers.IfUnmodifiedSince.ToString());
}

另请参阅

• DateTime
• HttpRequestMessage
• Headers
• IfModifiedSince