HttpConnectionOptionHeaderValueCollection Clase

Definición

Espacio de nombres:

Windows.Web.Http.Headers

Representa el valor del encabezado HTTP de conexión en una solicitud 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)]
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)]
public sealed class HttpConnectionOptionHeaderValueCollection : IEnumerable<HttpConnectionOptionHeaderValue>, IList<HttpConnectionOptionHeaderValue>, IStringable

Public NotInheritable Class HttpConnectionOptionHeaderValueCollection
Implements IEnumerable(Of HttpConnectionOptionHeaderValue), IList(Of HttpConnectionOptionHeaderValue), IStringable

Herencia

Object Platform::Object IInspectable HttpConnectionOptionHeaderValueCollection

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementaciones

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

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 de conexión en un objeto HttpRequestMessage mediante las propiedades y métodos de las clases HttpConnectionOptionHeaderValueCollection y 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());
        }

Comentarios

HttpConnectionOptionHeaderValueCollection representa el valor del encabezado HTTP de conexión en una solicitud HTTP.

HttpConnectionOptionHeaderValueCollection es una colección de objetos HttpConnectionOptionHeaderValue usados para la información de conexión en el encabezado de conexión HTTP.

La propiedad Connection de HttpRequestHeaderCollection devuelve un objeto HttpConnectionOptionHeaderValueCollection.

Listas de miembros de la colección

Para JavaScript, HttpConnectionOptionHeaderValueCollection tiene los miembros que se muestran en las listas de miembros. Además, HttpConnectionOptionHeaderValueCollection admite miembros de Array.prototype y el uso de un índice para acceder a los elementos.

Enumeración de la colección en C# o Microsoft Visual Basic

Puede recorrer en iteración un objeto HttpConnectionOptionHeaderValueCollection en C# o Microsoft Visual Basic. En muchos casos, como el uso de la sintaxis foreach , el compilador realiza esta conversión por usted y no tendrá que convertir a IEnumerable<HttpConnectionOptionHeaderValue> explícitamente. Si necesita convertir explícitamente, por ejemplo, si desea llamar a GetEnumerator, convierta el objeto de colección en IEnumerable<T> con una restricción HttpConnectionOptionHeaderValue .

Propiedades

Size	Obtiene el número de objetos HttpConnectionOptionHeaderValue de la colección.

Métodos

Append(HttpConnectionOptionHeaderValue)	Agrega un nuevo elemento HttpConnectionOptionHeaderValue al final de la colección.
Clear()	Quita todos los objetos HttpConnectionOptionHeaderValue de la colección.
First()	Recupera un iterador en el primer elemento HttpConnectionOptionHeaderValue de la colección.
GetAt(UInt32)	Devuelve httpConnectionOptionHeaderValue en el índice especificado de la colección.
GetMany(UInt32, HttpConnectionOptionHeaderValue[])	Recupera los elementos HttpConnectionOptionHeaderValue que comienzan en el índice especificado de la colección.
GetView()	Devuelve una vista inmutable de HttpConnectionOptionHeaderValueCollection.
IndexOf(HttpConnectionOptionHeaderValue, UInt32)	Recupera el índice de httpConnectionOptionHeaderValue en la colección.
InsertAt(UInt32, HttpConnectionOptionHeaderValue)	Inserta httpConnectionOptionHeaderValue en la colección en el índice especificado.
ParseAdd(String)	Analiza y agrega una entrada a httpConnectionOptionHeaderValueCollection.
RemoveAt(UInt32)	Quita la entrada en el índice especificado de httpConnectionOptionHeaderValueCollection.
RemoveAtEnd()	Quita el último elemento HttpConnectionOptionHeaderValue de la colección.
ReplaceAll(HttpConnectionOptionHeaderValue[])	Reemplaza todos los elementos HttpConnectionOptionHeaderValue de la colección por los elementos HttpConnectionOptionHeaderValue especificados.
SetAt(UInt32, HttpConnectionOptionHeaderValue)	Establece HttpConnectionOptionHeaderValue en el índice especificado de la colección.
ToString()	Devuelve una cadena que representa el objeto HttpConnectionOptionHeaderValueCollection actual.
TryParseAdd(String)	Intenta analizar y agregar el elemento especificado a httpConnectionOptionHeaderValueCollection.

Consulte también

• Connection
• HttpConnectionOptionHeaderValue
• HttpRequestHeaderCollection
• HttpRequestMessage
• IIterable<T>
• IStringable
• IVector<T>