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>

DateTime物件，表示 HTTP 要求上If-Unmodified-Since HTTP 標頭的值。 Null 值表示標頭不存在。

備註

IfUnmodifiedSince 屬性代表 HTTP 要求訊息上 If-Unmodified-Since HTTP 標頭的值。 If-Unmodified-Since標頭是內容自之後未修改的日期和時間。

JAVAscript 和 .NET 語言不會直接使用 DateTime 物件。 在 JAVAscript 中， DateTime 會投影為 物件，並在 .NET 中投影為 System.DateTimeOffset。 每個語言都會以透明方式處理個別語言的資料細微性和日期範圍轉換。

在 C++ 中，值的資料細微性與 相同，並支援 JAVAscript 和 .NET 所需的日期範圍。

如需詳細資訊，請參閱 Windows.Foundation.DateTime 結構。

下列範例程式碼示範如何在HttpRequestMessage物件上使用HttpRequestHeaderCollection物件的 IfUnmodifiedSince 屬性來設定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