Compartilhar via


HttpConnectionOptionHeaderValueCollection Classe

Definição

Representa o valor do cabeçalho HTTP de conexão em uma solicitação HTTP.

public ref class HttpConnectionOptionHeaderValueCollection sealed : IIterable<HttpConnectionOptionHeaderValue ^>, IVector<HttpConnectionOptionHeaderValue ^>, 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 HttpConnectionOptionHeaderValueCollection final : IIterable<HttpConnectionOptionHeaderValue>, IVector<HttpConnectionOptionHeaderValue>, IStringable
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class HttpConnectionOptionHeaderValueCollection final : IIterable<HttpConnectionOptionHeaderValue>, IVector<HttpConnectionOptionHeaderValue>, 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 HttpConnectionOptionHeaderValueCollection : IEnumerable<HttpConnectionOptionHeaderValue>, IList<HttpConnectionOptionHeaderValue>, IStringable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class HttpConnectionOptionHeaderValueCollection : IEnumerable<HttpConnectionOptionHeaderValue>, IList<HttpConnectionOptionHeaderValue>, IStringable
Public NotInheritable Class HttpConnectionOptionHeaderValueCollection
Implements IEnumerable(Of HttpConnectionOptionHeaderValue), IList(Of HttpConnectionOptionHeaderValue), IStringable
Herança
Object Platform::Object IInspectable HttpConnectionOptionHeaderValueCollection
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 HTTP connection em um objeto HttpRequestMessage usando as propriedades e métodos nas classes HttpConnectionOptionHeaderValueCollection e HttpConnectionOptionHeaderValue .

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

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

            // Set the header with a string.
            parsedOk = request.Headers.Connection.TryParseAdd("close");

            // Set the header with a strong type.
            request.Headers.Connection.Add(new HttpConnectionOptionHeaderValue("cache-control"));

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

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

Comentários

O HttpConnectionOptionHeaderValueCollection representa o valor do cabeçalho HTTP connection em uma solicitação HTTP.

O HttpConnectionOptionHeaderValueCollection é uma coleção de objetos HttpConnectionOptionHeaderValue usados para informações de conexão no cabeçalho http connection .

A propriedade Connection no HttpRequestHeaderCollection retorna um objeto HttpConnectionOptionHeaderValueCollection.

Listas de membros da coleção

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

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

Você pode iterar por meio de um objeto HttpConnectionOptionHeaderValueCollection 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<HttpConnectionOptionHeaderValue> 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 HttpConnectionOptionHeaderValue .

Propriedades

Size

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

Métodos

Append(HttpConnectionOptionHeaderValue)

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

Clear()

Remove todos os objetos HttpConnectionOptionHeaderValue da coleção.

First()

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

GetAt(UInt32)

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

GetMany(UInt32, HttpConnectionOptionHeaderValue[])

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

GetView()

Retorna uma exibição imutável do HttpConnectionOptionHeaderValueCollection.

IndexOf(HttpConnectionOptionHeaderValue, UInt32)

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

InsertAt(UInt32, HttpConnectionOptionHeaderValue)

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

ParseAdd(String)

Analisa e adiciona uma entrada ao HttpConnectionOptionHeaderValueCollection.

RemoveAt(UInt32)

Remove a entrada no índice especificado do HttpConnectionOptionHeaderValueCollection.

RemoveAtEnd()

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

ReplaceAll(HttpConnectionOptionHeaderValue[])

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

SetAt(UInt32, HttpConnectionOptionHeaderValue)

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

ToString()

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

TryParseAdd(String)

Tenta analisar e adicionar o item especificado ao HttpConnectionOptionHeaderValueCollection.

Aplica-se a

Confira também