HttpCacheDirectiveHeaderValueCollection Classe

Définition

Espace de noms:

Windows.Web.Http.Headers

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)]
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

Héritage

Object Platform::Object IInspectable HttpCacheDirectiveHeaderValueCollection

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Implémente

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

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.

Voir aussi

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