HttpProductInfoHeaderValueCollection Classe

Definição

Namespace:

Windows.Web.Http.Headers

Representa o valor do cabeçalho HTTP User-Agent em uma solicitação HTTP.

public ref class HttpProductInfoHeaderValueCollection sealed : IIterable<HttpProductInfoHeaderValue ^>, IVector<HttpProductInfoHeaderValue ^>, IStringable

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

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

Public NotInheritable Class HttpProductInfoHeaderValueCollection
Implements IEnumerable(Of HttpProductInfoHeaderValue), IList(Of HttpProductInfoHeaderValue), IStringable

Herança

Object Platform::Object IInspectable HttpProductInfoHeaderValueCollection

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementações

IIterable<T> IEnumerable<T> IIterable<HttpProductInfoHeaderValue> IEnumerable<HttpProductInfoHeaderValue> IVector<HttpProductInfoHeaderValue> IList<HttpProductInfoHeaderValue> 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 User-Agent em um objeto HttpRequestMessage usando as propriedades e métodos nas classes HttpProductInfoHeaderValueCollection e HttpProductInfoHeaderValue .

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

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

            // Set the header with a string.
            parsedOk = request.Headers.UserAgent.TryParseAdd("testprogram/1.0");

            // Set the header with a strong type.
            request.Headers.UserAgent.Add(new HttpProductInfoHeaderValue("myprogram", "2.2"));

            // Get the strong type out 
            foreach (var value in request.Headers.UserAgent) {
                System.Diagnostics.Debug.WriteLine("One of the UserAgent values: {0} / {1}", value.Product.Name, value.Product.Version);
            }

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

Comentários

O HttpProductInfoHeaderValueCollection representa o valor do cabeçalho HTTP User-Agent em uma solicitação HTTP.

O HttpProductInfoHeaderValueCollection é uma coleção de objetos HttpProductInfoHeaderValue usados para informações do produto no cabeçalho HTTP User-Agent .

O cabeçalho User-Agent contém informações sobre o agente de usuário que originou a solicitação. O cabeçalho User-Agent pode conter vários tokens de produto e comentários que identificam o agente do usuário e quaisquer subprodutos.

A propriedade UserAgent no objeto HttpRequestHeaderCollection retorna um objeto HttpProductInfoHeaderValueCollection.

Propriedades

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

Métodos

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

Confira também

• HttpProductInfoHeaderValue
• HttpRequestHeaderCollection
• IIterable<T>
• IStringable
• IVector<T>
• UserAgent