HttpRequestHeaderCollection.IfModifiedSince プロパティ

定義

名前空間:

Windows.Web.Http.Headers

HTTP 要求の If-Modified-Since HTTP ヘッダーの値を表す DateTime オブジェクトを取得または設定します。

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

IReference<DateTime> IfModifiedSince();

void IfModifiedSince(IReference<DateTime> value);

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

var iReference = httpRequestHeaderCollection.ifModifiedSince;
httpRequestHeaderCollection.ifModifiedSince = iReference;

Public Property IfModifiedSince As Nullable(Of DateTimeOffset)

プロパティ値

IReference<DateTime>

Nullable<DateTimeOffset>

HTTP 要求の If-Modified-Since HTTP ヘッダーの値を表す DateTime オブジェクト。 null 値は、ヘッダーが存在しないことを意味します。

注釈

IfModifiedSince プロパティは、HTTP 要求メッセージの If-Modified-Since HTTP ヘッダーの値を表します。 If-Modified-Since ヘッダーは、コンテンツが変更された日時です。

Javascript と .NET の言語では 、DateTime オブジェクトは直接使用されません。 Javascript では 、DateTime はオブジェクトとして投影され、.NET では System.DateTimeOffset として投影されます。 各言語は、それぞれの言語の粒度と日付範囲への変換を透過的に処理します。

C++ では、値の粒度は と同じであり、Javascript と .NET で必要な日付範囲がサポートされます。

詳細については、 Windows.Foundation.DateTime 構造体を参照してください。

次のサンプル コードは、HttpRequestHeaderCollection オブジェクトの IfModifiedSince プロパティを使用して、HttpRequestMessage オブジェクトに If-Modified-Since ヘッダーを設定するメソッドを示しています。

public void DemonstrateHeaderRequestIfModifiedSince() {
    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.IfModifiedSince = value;

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

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

こちらもご覧ください

• DateTime
• HttpRequestMessage
• Headers
• IfUnmodifiedSince