Compartilhar via


HttpMediaTypeWithQualityHeaderValueCollection Classe

Definição

Representa o valor do cabeçalho Aceitar HTTP em uma solicitação 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
Herança
Object Platform::Object IInspectable HttpMediaTypeWithQualityHeaderValueCollection
Atributos
Implementações

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O código de exemplo a seguir mostra um método para obter e definir o cabeçalho Accept HTTP em um objeto HttpRequestMessage usando as propriedades e métodos nas classes HttpMediaTypeWithQualityHeaderValueCollection e 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());
        }

Comentários

O HttpMediaTypeWithQualityHeaderValueCollection representa o valor do cabeçalho Accept HTTP em uma solicitação HTTP.

O HttpMediaTypeWithQualityHeaderValueCollection é uma coleção de objetos HttpMediaTypeWithQualityHeaderValue usados para aceitar informações no cabeçalho HTTP Accept .

A propriedade Accept no HttpRequestHeaderCollection retorna um objeto HttpMediaTypeWithQualityHeaderValueCollection.

Propriedades

Size

Obtém o número de objetos HttpMediaTypeWithQualityHeaderValue na coleção.

Métodos

Append(HttpMediaTypeWithQualityHeaderValue)

Adiciona um novo item HttpMediaTypeWithQualityHeaderValue ao final da coleção.

Clear()

Remove todos os objetos da coleção.

First()

Recupera um iterador para o primeiro item HttpMediaTypeWithQualityHeaderValue na coleção.

GetAt(UInt32)

Retorna o HttpMediaTypeWithQualityHeaderValue no índice especificado na coleção.

GetMany(UInt32, HttpMediaTypeWithQualityHeaderValue[])

Recupera os itens HttpMediaTypeWithQualityHeaderValue que começam no índice especificado na coleção.

GetView()

Retorna uma exibição imutável de HttpMediaTypeWithQualityHeaderValueCollection.

IndexOf(HttpMediaTypeWithQualityHeaderValue, UInt32)

Recupera o índice de um HttpMediaTypeWithQualityHeaderValue na coleção.

InsertAt(UInt32, HttpMediaTypeWithQualityHeaderValue)

Insere um HttpMediaTypeWithQualityHeaderValue na coleção no índice especificado.

ParseAdd(String)

Analisa e adiciona uma entrada ao HttpMediaTypeWithQualityHeaderValueCollection.

RemoveAt(UInt32)

Remove a entrada no índice especificado do HttpMediaTypeWithQualityHeaderValueCollection.

RemoveAtEnd()

Remove o último item HttpMediaTypeWithQualityHeaderValue da coleção.

ReplaceAll(HttpMediaTypeWithQualityHeaderValue[])

Substitui todos os itens HttpMediaTypeWithQualityHeaderValue na coleção pelos itens HttpMediaTypeWithQualityHeaderValue especificados.

SetAt(UInt32, HttpMediaTypeWithQualityHeaderValue)

Define o HttpMediaTypeWithQualityHeaderValue no índice especificado na coleção.

ToString()

Retorna uma cadeia de caracteres que representa o objeto HttpMediaTypeWithQualityHeaderValueCollection atual.

TryParseAdd(String)

Tenta analisar e adicionar o item especificado ao HttpMediaTypeWithQualityHeaderValueCollection.

Aplica-se a

Confira também