Partager via


HttpCacheDirectiveHeaderValueCollection Classe

Définition

Représente la valeur de l’en-tête HTTP Cache-Control sur le contenu HTTP associé à une requête ou à une réponse 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)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class HttpCacheDirectiveHeaderValueCollection final : 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)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class HttpCacheDirectiveHeaderValueCollection : IEnumerable<HttpNameValueHeaderValue>, IList<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
Héritage
Object Platform::Object IInspectable HttpCacheDirectiveHeaderValueCollection
Attributs
Implémente

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

L’exemple de code suivant montre une méthode permettant d’obtenir et de définir l’en-tête HTTP Cache-Control sur un objet HttpRequestMessage à l’aide des propriétés et des méthodes de la 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());
        }

L’exemple de code suivant montre une méthode permettant d’obtenir et de définir l’en-tête HTTP Cache-Control sur un objet HttpResponseMessage à l’aide des propriétés et des méthodes de la 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());
        }

Remarques

La classe HttpCacheDirectiveHeaderValueCollection représente la valeur de l’en-tête HTTP Cache-Control sur le contenu HTTP associé à une requête HTTP ou à une réponse HTTP.

La propriété CacheControl sur httpRequestHeaderCollection retourne une propriété HttpCacheDirectiveHeaderValueCollection. La propriété CacheControl sur httpResponseHeaderCollection retourne une propriété HttpCacheDirectiveHeaderValueCollection.

Listes de membres de la collection

Pour JavaScript, HttpCacheDirectiveHeaderValueCollection contient les membres affichés dans les listes de membres. En outre, HttpCacheDirectiveHeaderValueCollection prend en charge les membres de Array.prototype et l’utilisation d’un index pour accéder aux éléments.

Énumération de la collection en C# ou Microsoft Visual Basic

Vous pouvez itérer via un objet HttpCacheDirectiveHeaderValueCollection en C# ou Microsoft Visual Basic. Dans de nombreux cas, comme l’utilisation de la syntaxe foreach , le compilateur effectue cette cast pour vous et vous n’aurez pas besoin d’effectuer IEnumerable<HttpNameValueHeaderValue> un cast vers explicitement. Si vous avez besoin d’un cast explicite, par exemple si vous souhaitez appeler GetEnumerator, castez l’objet de collection en IEnumerable<T> avec une contrainte HttpNameValueHeaderValue .

Propriétés

MaxAge

Obtient ou définit la valeur de la directive max-age dans l’en-tête HTTP Cache-Control .

MaxStale

Obtient ou définit la valeur de la directive max-stale dans l’en-tête HTTP Cache-Control .

MinFresh

Obtient ou définit la valeur de la directive min-fresh dans l’en-tête HTTP Cache-Control .

SharedMaxAge

Obtient ou définit la valeur de la directive s-maxage dans l’en-tête HTTP Cache-Control .

Size

Obtient le nombre d’objets HttpNameValueHeaderValue dans la collection.

Méthodes

Append(HttpNameValueHeaderValue)

Ajoute un nouvel élément HttpNameValueHeaderValue à la fin de la collection.

Clear()

Supprime tous les objets de la collection.

First()

Récupère un itérateur vers le premier élément HttpNameValueHeaderValue de la collection.

GetAt(UInt32)

Renvoie la valeur HttpNameValueHeaderValue à l’index spécifié dans la collection.

GetMany(UInt32, HttpNameValueHeaderValue[])

Récupère les éléments HttpNameValueHeaderValue qui commencent à l’index spécifié dans la collection.

GetView()

Renvoie une vue immuable de HttpCacheDirectiveHeaderValueCollection.

IndexOf(HttpNameValueHeaderValue, UInt32)

Récupère l’index d’un HttpNameValueHeaderValue dans la collection.

InsertAt(UInt32, HttpNameValueHeaderValue)

Insère une valeur HttpNameValueHeaderValue dans la collection à l’index spécifié.

ParseAdd(String)

Analyse et ajoute une entrée à HttpCacheDirectiveHeaderValueCollection.

RemoveAt(UInt32)

Supprime l’entrée à l’index spécifié de HttpCacheDirectiveHeaderValueCollection.

RemoveAtEnd()

Supprime le dernier élément HttpNameValueHeaderValue de la collection.

ReplaceAll(HttpNameValueHeaderValue[])

Remplace tous les éléments HttpNameValueHeaderValue de la collection par les éléments HttpNameValueHeaderValue spécifiés.

SetAt(UInt32, HttpNameValueHeaderValue)

Définit httpNameValueHeaderValue à l’index spécifié dans la collection.

ToString()

Renvoie une chaîne qui représente l’objet HttpCacheDirectiveHeaderValueCollection actuel.

TryParseAdd(String)

Tente d’analyser et d’ajouter l’élément spécifié à HttpCacheDirectiveHeaderValueCollection.

S’applique à

Voir aussi