HttpMediaTypeWithQualityHeaderValueCollection Clase

Definición

Representa el valor del encabezado Accept HTTP en una solicitud HTTP.

public ref class HttpMediaTypeWithQualityHeaderValueCollection sealed : IIterable<HttpMediaTypeWithQualityHeaderValue ^>, IVector<HttpMediaTypeWithQualityHeaderValue ^>, 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 HttpMediaTypeWithQualityHeaderValueCollection final : IIterable<HttpMediaTypeWithQualityHeaderValue>, IVector<HttpMediaTypeWithQualityHeaderValue>, IStringable
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class HttpMediaTypeWithQualityHeaderValueCollection final : IIterable<HttpMediaTypeWithQualityHeaderValue>, IVector<HttpMediaTypeWithQualityHeaderValue>, 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 HttpMediaTypeWithQualityHeaderValueCollection : IEnumerable<HttpMediaTypeWithQualityHeaderValue>, IList<HttpMediaTypeWithQualityHeaderValue>, IStringable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class HttpMediaTypeWithQualityHeaderValueCollection : IEnumerable<HttpMediaTypeWithQualityHeaderValue>, IList<HttpMediaTypeWithQualityHeaderValue>, IStringable
Public NotInheritable Class HttpMediaTypeWithQualityHeaderValueCollection
Implements IEnumerable(Of HttpMediaTypeWithQualityHeaderValue), IList(Of HttpMediaTypeWithQualityHeaderValue), IStringable
Herencia
Object Platform::Object IInspectable HttpMediaTypeWithQualityHeaderValueCollection
Atributos
Implementaciones

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 Accept en un objeto HttpRequestMessage mediante las propiedades y métodos de las clases HttpMediaTypeWithQualityHeaderValueCollection y HttpMediaTypeWithQualityHeaderValue .

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

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

            // Set the header with a string.
            parsedOk = request.Headers.Accept.TryParseAdd ("audio/*");
            parsedOk = request.Headers.Accept.TryParseAdd ("audio/*; q=0.2");
            parsedOk = request.Headers.Accept.TryParseAdd ("audio/*; q=0.4; mysetting=myvalue");

            // Set the header with a strong type.
            request.Headers.Accept.Add(new HttpMediaTypeWithQualityHeaderValue("audio/*", .6));

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

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

Comentarios

HttpMediaTypeWithQualityHeaderValueCollection representa el valor del encabezado HTTP Accept en una solicitud HTTP.

HttpMediaTypeWithQualityHeaderValueCollection es una colección de objetos HttpMediaTypeWithQualityHeaderValue usados para aceptar información en el encabezado HTTP Accept .

La propiedad Accept en httpRequestHeaderCollection devuelve un objeto HttpMediaTypeWithQualityHeaderValueCollection.

Propiedades

Size

Obtiene el número de objetos HttpMediaTypeWithQualityHeaderValue de la colección.

Métodos

Append(HttpMediaTypeWithQualityHeaderValue)

Agrega un nuevo elemento HttpMediaTypeWithQualityHeaderValue al final de la colección.

Clear()

Quita todos los objetos de la colección.

First()

Recupera un iterador en el primer elemento HttpMediaTypeWithQualityHeaderValue de la colección.

GetAt(UInt32)

Devuelve HttpMediaTypeWithQualityHeaderValue en el índice especificado de la colección.

GetMany(UInt32, HttpMediaTypeWithQualityHeaderValue[])

Recupera los elementos HttpMediaTypeWithQualityHeaderValue que comienzan en el índice especificado de la colección.

GetView()

Devuelve una vista inmutable de HttpMediaTypeWithQualityHeaderValueCollection.

IndexOf(HttpMediaTypeWithQualityHeaderValue, UInt32)

Recupera el índice de httpMediaTypeWithQualityHeaderValue en la colección.

InsertAt(UInt32, HttpMediaTypeWithQualityHeaderValue)

Inserta httpMediaTypeWithQualityHeaderValue en la colección en el índice especificado.

ParseAdd(String)

Analiza y agrega una entrada a HttpMediaTypeWithQualityHeaderValueCollection.

RemoveAt(UInt32)

Quita la entrada en el índice especificado de HttpMediaTypeWithQualityHeaderValueCollection.

RemoveAtEnd()

Quita el último elemento HttpMediaTypeWithQualityHeaderValue de la colección.

ReplaceAll(HttpMediaTypeWithQualityHeaderValue[])

Reemplaza todos los elementos HttpMediaTypeWithQualityHeaderValue de la colección por los elementos HttpMediaTypeWithQualityHeaderValue especificados.

SetAt(UInt32, HttpMediaTypeWithQualityHeaderValue)

Establece HttpMediaTypeWithQualityHeaderValue en el índice especificado de la colección.

ToString()

Devuelve una cadena que representa el objeto HttpMediaTypeWithQualityHeaderValueCollection actual.

TryParseAdd(String)

Intenta analizar y agregar el elemento especificado a httpMediaTypeWithQualityHeaderValueCollection.

Se aplica a

Consulte también