HttpCacheDirectiveHeaderValueCollection Clase

Definición

Espacio de nombres:

Windows.Web.Http.Headers

Representa el valor del encabezado HTTP Cache-Control en el contenido HTTP asociado a una solicitud o respuesta 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

Herencia

Object Platform::Object IInspectable HttpCacheDirectiveHeaderValueCollection

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementaciones

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

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

El código de ejemplo siguiente muestra un método para obtener y establecer el encabezado HTTP Cache-Control en un objeto HttpRequestMessage mediante las propiedades y métodos de la clase 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());
        }

En el código de ejemplo siguiente se muestra un método para obtener y establecer el encabezado HTTP Cache-Control en un objeto HttpResponseMessage mediante las propiedades y métodos de la clase 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());
        }

Comentarios

La clase HttpCacheDirectiveHeaderValueCollection representa el valor del encabezado HTTP Cache-Control en el contenido HTTP asociado a una solicitud HTTP o una respuesta HTTP.

La propiedad CacheControl de HttpRequestHeaderCollection devuelve una httpCacheDirectiveHeaderValueCollection. La propiedad CacheControl de HttpResponseHeaderCollection devuelve una httpCacheDirectiveHeaderValueCollection.

Listas de miembros de la colección

Para JavaScript, HttpCacheDirectiveHeaderValueCollection tiene los miembros que se muestran en las listas de miembros. Además, HttpCacheDirectiveHeaderValueCollection admite miembros de Array.prototype y usa un índice para acceder a los elementos.

Enumeración de la colección en C# o Microsoft Visual Basic

Puede recorrer en iteración un objeto HttpCacheDirectiveHeaderValueCollection en C# o Microsoft Visual Basic. En muchos casos, como el uso de la sintaxis foreach , el compilador realiza esta conversión por usted y no tendrá que convertir a IEnumerable<HttpNameValueHeaderValue> explícitamente. Si necesita convertir explícitamente, por ejemplo, si desea llamar a GetEnumerator, convierta el objeto de colección en IEnumerable<T> con una restricción HttpNameValueHeaderValue .

Propiedades

MaxAge	Obtiene o establece el valor de la directiva max-age en el encabezado HTTP Cache-Control .
MaxStale	Obtiene o establece el valor de la directiva max-stale en el encabezado HTTP Cache-Control .
MinFresh	Obtiene o establece el valor de la directiva min-fresh en el encabezado HTTP Cache-Control .
SharedMaxAge	Obtiene o establece el valor de la directiva s-maxage en el encabezado HTTP Cache-Control .
Size	Obtiene el número de objetos HttpNameValueHeaderValue de la colección.

Métodos

Append(HttpNameValueHeaderValue)	Agrega un nuevo elemento HttpNameValueHeaderValue al final de la colección.
Clear()	Quita todos los objetos de la colección.
First()	Recupera un iterador en el primer elemento HttpNameValueHeaderValue de la colección.
GetAt(UInt32)	Devuelve HttpNameValueHeaderValue en el índice especificado de la colección.
GetMany(UInt32, HttpNameValueHeaderValue[])	Recupera los elementos HttpNameValueHeaderValue que comienzan en el índice especificado de la colección.
GetView()	Devuelve una vista inmutable de HttpCacheDirectiveHeaderValueCollection.
IndexOf(HttpNameValueHeaderValue, UInt32)	Recupera el índice de httpNameValueHeaderValue en la colección.
InsertAt(UInt32, HttpNameValueHeaderValue)	Inserta httpNameValueHeaderValue en la colección en el índice especificado.
ParseAdd(String)	Analiza y agrega una entrada a HttpCacheDirectiveHeaderValueCollection.
RemoveAt(UInt32)	Quita la entrada en el índice especificado de HttpCacheDirectiveHeaderValueCollection.
RemoveAtEnd()	Quita el último elemento HttpNameValueHeaderValue de la colección.
ReplaceAll(HttpNameValueHeaderValue[])	Reemplaza todos los elementos HttpNameValueHeaderValue de la colección por los elementos HttpNameValueHeaderValue especificados.
SetAt(UInt32, HttpNameValueHeaderValue)	Establece HttpNameValueHeaderValue en el índice especificado de la colección.
ToString()	Devuelve una cadena que representa el objeto HttpCacheDirectiveHeaderValueCollection actual.
TryParseAdd(String)	Intenta analizar y agregar el elemento especificado a httpCacheDirectiveHeaderValueCollection.

Consulte también

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