HttpContentCodingWithQualityHeaderValueCollection Classe

Definição

Namespace:

Windows.Web.Http.Headers

Representa o valor do cabeçalho HTTP accept-encoding em uma solicitação HTTP.

public ref class HttpContentCodingWithQualityHeaderValueCollection sealed : IIterable<HttpContentCodingWithQualityHeaderValue ^>, IVector<HttpContentCodingWithQualityHeaderValue ^>, IStringable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class HttpContentCodingWithQualityHeaderValueCollection final : IIterable<HttpContentCodingWithQualityHeaderValue>, IVector<HttpContentCodingWithQualityHeaderValue>, IStringable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class HttpContentCodingWithQualityHeaderValueCollection : IEnumerable<HttpContentCodingWithQualityHeaderValue>, IList<HttpContentCodingWithQualityHeaderValue>, IStringable

Public NotInheritable Class HttpContentCodingWithQualityHeaderValueCollection
Implements IEnumerable(Of HttpContentCodingWithQualityHeaderValue), IList(Of HttpContentCodingWithQualityHeaderValue), IStringable

Herança

Object Platform::Object IInspectable HttpContentCodingWithQualityHeaderValueCollection

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementações

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

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 HTTP Accept-Encoding em um objeto HttpRequestMessage usando as propriedades e métodos nas classes HttpContentCodingWithQualityHeaderValueCollection e HttpContentCodingWithQualityHeaderValue .

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

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

            // Set the header with a string.
            parsedOk = request.Headers.AcceptEncoding.TryParseAdd("compress");
            parsedOk = request.Headers.AcceptEncoding.TryParseAdd("gzip;q=1.0");

            // Set the header with a strong type.
            request.Headers.AcceptEncoding.Add(new HttpContentCodingWithQualityHeaderValue("*", 0));

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

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

Comentários

A classe HttpContentCodingWithQualityHeaderValueCollection representa o valor do cabeçalho HTTP Accept-Encoding em uma solicitação HTTP.

O HttpContentCodingWithQualityHeaderValueCollection fornece um contêiner de coleção para instâncias da classe HttpContentCodingWithQualityHeaderValue usada para aceitar informações de codificação no cabeçalho HTTP Accept-Encoding .

A propriedade AcceptEncoding no HttpRequestHeaderCollection retorna um objeto HttpContentCodingWithQualityHeaderValueCollection. Esse é o método usado para construir um objeto HttpContentCodingWithQualityHeaderValueCollection.

Listas de membros da coleção

Para JavaScript, HttpContentCodingWithQualityHeaderValueCollection tem os membros mostrados nas listas de membros. Além disso, HttpContentCodingWithQualityHeaderValueCollection dá suporte a membros do Array.prototype e ao usar um índice para acessar itens.

Enumerando a coleção em C# ou Microsoft Visual Basic

Você pode iterar por meio de um objeto HttpContentCodingWithQualityHeaderValueCollection em C# ou Microsoft Visual Basic. Em muitos casos, como o uso da sintaxe foreach , o compilador faz essa conversão para você e você não precisará converter IEnumerable<HttpContentCodingWithQualityHeaderValue> explicitamente. Se você precisar converter explicitamente, por exemplo, se quiser chamar GetEnumerator, converta o objeto de coleção para IEnumerable<T> com uma restrição HttpContentCodingWithQualityHeaderValue .

Propriedades

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

Métodos

Append(HttpContentCodingWithQualityHeaderValue)	Adiciona um novo item HttpContentCodingWithQualityHeaderValue ao final da coleção.
Clear()	Remove todos os objetos da coleção.
First()	Recupera um iterador para o primeiro item HttpContentCodingWithQualityHeaderValue na coleção.
GetAt(UInt32)	Retorna o HttpContentCodingWithQualityHeaderValue no índice especificado na coleção.
GetMany(UInt32, HttpContentCodingWithQualityHeaderValue[])	Recupera os itens HttpContentCodingWithQualityHeaderValue que começam no índice especificado na coleção.
GetView()	Retorna uma exibição imutável do HttpContentCodingWithQualityHeaderValueCollection.
IndexOf(HttpContentCodingWithQualityHeaderValue, UInt32)	Recupera o índice de um HttpContentCodingWithQualityHeaderValue na coleção.
InsertAt(UInt32, HttpContentCodingWithQualityHeaderValue)	Insere um HttpContentCodingWithQualityHeaderValue na coleção no índice especificado.
ParseAdd(String)	Analisa e adiciona uma entrada ao HttpContentCodingWithQualityHeaderValueCollection.
RemoveAt(UInt32)	Remove a entrada no índice especificado do HttpContentCodingWithQualityHeaderValueCollection.
RemoveAtEnd()	Remove o último item HttpContentCodingWithQualityHeaderValue da coleção.
ReplaceAll(HttpContentCodingWithQualityHeaderValue[])	Substitui todos os itens HttpContentCodingWithQualityHeaderValue na coleção pelos itens HttpContentCodingWithQualityHeaderValue especificados.
SetAt(UInt32, HttpContentCodingWithQualityHeaderValue)	Define httpContentCodingWithQualityHeaderValue no índice especificado na coleção.
ToString()	Retorna uma cadeia de caracteres que representa o objeto HttpContentCodingWithQualityHeaderValueCollection atual.
TryParseAdd(String)	Tenta analisar e adicionar o item especificado ao HttpContentCodingWithQualityHeaderValueCollection.

Confira também

• AcceptEncoding
• HttpContentCodingWithQualityHeaderValue
• HttpRequestHeaderCollection
• HttpRequestMessage
• IIterable<T>
• IStringable
• IVector<T>