HttpCacheDirectiveHeaderValueCollection Classe

Definizione

Spazio dei nomi:

Windows.Web.Http.Headers

Rappresenta il valore dell'intestazione HTTP Cache-Control sul contenuto HTTP associato a una richiesta o a una risposta HTTP.

public ref class HttpCacheDirectiveHeaderValueCollection sealed : IIterable<HttpNameValueHeaderValue ^>, IVector<HttpNameValueHeaderValue ^>, IStringable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class HttpCacheDirectiveHeaderValueCollection final : IIterable<HttpNameValueHeaderValue>, IVector<HttpNameValueHeaderValue>, IStringable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class HttpCacheDirectiveHeaderValueCollection : IEnumerable<HttpNameValueHeaderValue>, IList<HttpNameValueHeaderValue>, IStringable

Public NotInheritable Class HttpCacheDirectiveHeaderValueCollection
Implements IEnumerable(Of HttpNameValueHeaderValue), IList(Of HttpNameValueHeaderValue), IStringable

Ereditarietà

Object Platform::Object IInspectable HttpCacheDirectiveHeaderValueCollection

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Implementazioni

IIterable<T> IEnumerable<T> IIterable<HttpNameValueHeaderValue> IEnumerable<HttpNameValueHeaderValue> IVector<HttpNameValueHeaderValue> IList<HttpNameValueHeaderValue> IStringable

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Il codice di esempio seguente illustra un metodo per ottenere e impostare l'intestazione HTTP Cache-Control su un oggetto HttpRequestMessage usando le proprietà e i metodi nella classe HttpCacheDirectiveHeaderValueCollection.

using System;
using Windows.Web.Http;
using Windows.Web.Http.Headers;

        public void DemonstrateHeaderRequestCacheControl() {
            var request = new HttpRequestMessage();
            bool parsedOk = false;

            // Set the header with a string.
            parsedOk = request.Headers.CacheControl.TryParseAdd("no-store");

            // Set the header with a strong type.
            request.Headers.CacheControl.Add(new HttpNameValueHeaderValue("max-age", "10"));

            // Get the strong type out
            foreach (var value in request.Headers.CacheControl) {
                System.Diagnostics.Debug.WriteLine("One of the CacheControl values: {0}={1}", value.Name, value.Value);
            }

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

Il codice di esempio seguente illustra un metodo per ottenere e impostare l'intestazione HTTP Cache-Control su un oggetto HttpResponseMessage usando le proprietà e i metodi nella classe HttpCacheDirectiveHeaderValueCollection.

using System;
using Windows.Web.Http;
using Windows.Web.Http.Headers;

        public void DemonstrateHeaderResponseCacheControl() {
            var response = new HttpResponseMessage();

            // Set the header with a string
            response.Headers.CacheControl.TryParseAdd("public");

            // Set the header with a strong type
            response.Headers.CacheControl.Add(new HttpNameValueHeaderValue("max-age", "30"));

            // Get the strong type out
            foreach (var value in response.Headers.CacheControl) {
                System.Diagnostics.Debug.WriteLine("CacheControl {0}={1}", value.Name, value.Value);
            }

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

Commenti

La classe HttpCacheDirectiveHeaderValueCollection rappresenta il valore dell'intestazione HTTP Cache-Control sul contenuto HTTP associato a una richiesta HTTP o a una risposta HTTP.

La proprietà CacheControl in HttpRequestHeaderCollection restituisce un oggetto HttpCacheDirectiveHeaderValueCollection. La proprietà CacheControl in HttpResponseHeaderCollection restituisce un oggetto HttpCacheDirectiveHeaderValueCollection.

Elenchi di membri della raccolta

Per JavaScript, HttpCacheDirectiveHeaderValueCollection include i membri visualizzati negli elenchi di membri. HttpCacheDirectiveHeaderValueCollection supporta inoltre i membri di Array.prototype e l'uso di un indice per accedere agli elementi.

Enumerazione della raccolta in C# o Microsoft Visual Basic

È possibile scorrere un oggetto HttpCacheDirectiveHeaderValueCollection in C# o Microsoft Visual Basic. In molti casi, ad esempio usando la sintassi foreach , il compilatore esegue questo cast per l'utente e non è necessario eseguire il cast in IEnumerable<HttpNameValueHeaderValue> modo esplicito. Se è necessario eseguire il cast in modo esplicito, ad esempio se si vuole chiamare GetEnumerator, eseguire il cast dell'oggetto raccolta in IEnumerable<T> con un vincolo HttpNameValueHeaderValue .

Proprietà

MaxAge	Ottiene o imposta il valore della direttiva max-age nell'intestazione HTTP Cache-Control .
MaxStale	Ottiene o imposta il valore della direttiva max-non aggiornata nell'intestazione HTTP Cache-Control .
MinFresh	Ottiene o imposta il valore della direttiva min-fresh nell'intestazione HTTP Cache-Control .
SharedMaxAge	Ottiene o imposta il valore della direttiva s-maxage nell'intestazione HTTP Cache-Control .
Size	Ottiene il numero di oggetti HttpNameValueHeaderValue nell'insieme.

Metodi

Append(HttpNameValueHeaderValue)	Aggiunge un nuovo elemento HttpNameValueHeaderValue alla fine della raccolta.
Clear()	Rimuove tutti gli oggetti dalla raccolta.
First()	Recupera un iteratore nel primo elemento HttpNameValueHeaderValue dell'insieme.
GetAt(UInt32)	Restituisce l'oggetto HttpNameValueHeaderValue in corrispondenza dell'indice specificato nell'insieme.
GetMany(UInt32, HttpNameValueHeaderValue[])	Recupera gli elementi HttpNameValueHeaderValue che iniziano in corrispondenza dell'indice specificato nella raccolta.
GetView()	Restituisce una visualizzazione non modificabile di HttpCacheDirectiveHeaderValueCollection.
IndexOf(HttpNameValueHeaderValue, UInt32)	Recupera l'indice di un valore HttpNameValueHeaderValue nell'insieme.
InsertAt(UInt32, HttpNameValueHeaderValue)	Inserisce un valore HttpNameValueHeaderValue nell'insieme in corrispondenza dell'indice specificato.
ParseAdd(String)	Analizza e aggiunge una voce a HttpCacheDirectiveHeaderValueCollection.
RemoveAt(UInt32)	Rimuove la voce in corrispondenza dell'indice specificato da HttpCacheDirectiveHeaderValueCollection.
RemoveAtEnd()	Rimuove l'ultimo elemento HttpNameValueHeaderValue dalla raccolta.
ReplaceAll(HttpNameValueHeaderValue[])	Sostituisce tutti gli elementi HttpNameValueHeaderValue nella raccolta con gli elementi HttpNameValueHeaderValue specificati.
SetAt(UInt32, HttpNameValueHeaderValue)	Imposta HttpNameValueHeaderValue in corrispondenza dell'indice specificato nell'insieme.
ToString()	Restituisce una stringa che rappresenta l'oggetto HttpCacheDirectiveHeaderValueCollection corrente.
TryParseAdd(String)	Tenta di analizzare e aggiungere l'elemento specificato a HttpCacheDirectiveHeaderValueCollection.

Vedi anche

• HttpResponseHeaderCollection
• CacheControl
• HttpRequestHeaderCollection
• CacheControl
• HttpResponseMessage
• IIterable<T>
• IStringable
• IVector<T>