HttpRequestHeaderCollection.IfModifiedSince Propriedade

Definição

Namespace:

Windows.Web.Http.Headers

Obtém ou define o objeto DateTime que representa o valor de um cabeçalho HTTP If-Modified-Since em uma solicitação HTTP.

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)

Valor da propriedade

IReference<DateTime>

Nullable<DateTimeOffset>

O objeto DateTime que representa o valor de um cabeçalho HTTP If-Modified-Since em uma solicitação HTTP. Um valor nulo significa que o cabeçalho está ausente.

Comentários

A propriedade IfModifiedSince representa o valor de um cabeçalho HTTP If-Modified-Since em uma mensagem de solicitação HTTP. O cabeçalho If-Modified-Since é a data e hora em que o conteúdo foi modificado desde então.

As linguagens Javascript e .NET não usam o objeto DateTime diretamente. Em Javascript, um DateTime é projetado como um objeto e, no .NET, ele é projetado como um System.DateTimeOffset. Cada linguagem manipula de forma transparente a conversão para a granularidade e os intervalos de datas para o respectivo idioma.

No C++, um valor tem a mesma granularidade que um e dá suporte aos intervalos de datas exigidos pelo Javascript e pelo .NET.

Para obter informações mais detalhadas, consulte a estrutura Windows.Foundation.DateTime .

O código de exemplo a seguir mostra um método para definir o cabeçalho If-Modified-Since em um objeto HttpRequestMessage usando a propriedade IfModifiedSince no objeto HttpRequestHeaderCollection .

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());
}

Confira também

• DateTime
• HttpRequestMessage
• Headers
• IfUnmodifiedSince