HttpCacheDirectiveHeaderValueCollection Klasse

Definition

Namespace:

Windows.Web.Http.Headers

Stellt den Wert des CACHE-Control-HTTP-Headers für HTTP-Inhalt dar, der einer HTTP-Anforderung oder -Antwort zugeordnet ist.

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

Vererbung

Object Platform::Object IInspectable HttpCacheDirectiveHeaderValueCollection

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert

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

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Der folgende Beispielcode zeigt eine Methode zum Abrufen und Festlegen des Cache-Control-HTTP-Headers für ein HttpRequestMessage-Objekt mithilfe der Eigenschaften und Methoden der HttpCacheDirectiveHeaderValueCollection-Klasse.

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

Der folgende Beispielcode zeigt eine Methode zum Abrufen und Festlegen des Cache-Control-HTTP-Headers für ein HttpResponseMessage-Objekt mithilfe der Eigenschaften und Methoden der HttpCacheDirectiveHeaderValueCollection-Klasse.

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

Hinweise

Die HttpCacheDirectiveHeaderValueCollection-Klasse stellt den Wert des CACHE-Control-HTTP-Headers für HTTP-Inhalt dar, der einer HTTP-Anforderung oder einer HTTP-Antwort zugeordnet ist.

Die CacheControl-Eigenschaft für httpRequestHeaderCollection gibt eine HttpCacheDirectiveHeaderValueCollection zurück. Die CacheControl-Eigenschaft für httpResponseHeaderCollection gibt eine HttpCacheDirectiveHeaderValueCollection zurück.

Auflistungselementlisten

Für JavaScript verfügt HttpCacheDirectiveHeaderValueCollection über die in den Memberlisten angezeigten Member. Darüber hinaus unterstützt HttpCacheDirectiveHeaderValueCollection Member von Array.prototype und die Verwendung eines Indexes für den Zugriff auf Elemente.

Auflisten der Sammlung in C# oder Microsoft Visual Basic

Sie können ein HttpCacheDirectiveHeaderValueCollection-Objekt in C# oder Microsoft Visual Basic durchlaufen. In vielen Fällen, z. B. mit foreach-Syntax , führt der Compiler diese Umwandlung für Sie durch, und Sie müssen nicht explizit in IEnumerable<HttpNameValueHeaderValue> umwandeln. Wenn Sie eine explizite Umwandlung durchführen müssen, z. B. wenn Sie GetEnumerator aufrufen möchten, wandeln Sie das Auflistungsobjekt mit einer HttpNameValueHeaderValueValue-Einschränkung in IEnumerable<T> um.

Eigenschaften

MaxAge	Ruft den Wert der max-age-Direktive im CACHE-Control-HTTP-Header ab oder legt den Wert fest.
MaxStale	Ruft den Wert der max-stale-Direktive im CACHE-Control-HTTP-Header ab oder legt den Wert fest.
MinFresh	Ruft den Wert der min-fresh-Direktive im CACHE-Control-HTTP-Header ab oder legt den Wert fest.
SharedMaxAge	Ruft den Wert der s-maxage-Direktive im CACHE-Control-HTTP-Header ab oder legt den Wert fest.
Size	Ruft die Anzahl der HttpNameValueHeaderValue-Objekte in der Auflistung ab.

Methoden

Append(HttpNameValueHeaderValue)	Fügt am Ende der Auflistung ein neues HttpNameValueHeaderValue-Element hinzu.
Clear()	Entfernt alle Objekte aus der Auflistung.
First()	Ruft einen Iterator für das erste HttpNameValueHeaderValue-Element in der Auflistung ab.
GetAt(UInt32)	Gibt den HttpNameValueHeaderValue am angegebenen Index in der Auflistung zurück.
GetMany(UInt32, HttpNameValueHeaderValue[])	Ruft die HttpNameValueHeaderValue-Elemente ab, die am angegebenen Index in der Auflistung beginnen.
GetView()	Gibt eine unveränderliche Ansicht der HttpCacheDirectiveHeaderValueCollection zurück.
IndexOf(HttpNameValueHeaderValue, UInt32)	Ruft den Index eines HttpNameValueHeaderValue in der Auflistung ab.
InsertAt(UInt32, HttpNameValueHeaderValue)	Fügt einen HttpNameValueHeaderValue am angegebenen Index in die Auflistung ein.
ParseAdd(String)	Analysiert und fügt der HttpCacheDirectiveHeaderValueCollection einen Eintrag hinzu.
RemoveAt(UInt32)	Entfernt den Eintrag am angegebenen Index aus der HttpCacheDirectiveHeaderValueCollection.
RemoveAtEnd()	Entfernt das letzte HttpNameValueHeaderValue-Element aus der Auflistung.
ReplaceAll(HttpNameValueHeaderValue[])	Ersetzt alle HttpNameValueHeaderValue-Elemente in der Auflistung durch die angegebenen HttpNameValueHeaderValue-Elemente .
SetAt(UInt32, HttpNameValueHeaderValue)	Legt den HttpNameValueHeaderValue auf den angegebenen Index in der Auflistung fest.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle HttpCacheDirectiveHeaderValueCollection-Objekt darstellt.
TryParseAdd(String)	Versucht, das angegebene Element zu analysieren und der HttpCacheDirectiveHeaderValueCollection hinzuzufügen.

Weitere Informationen

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