HttpConnectionOptionHeaderValueCollection Classe

Définition

Espace de noms:

Windows.Web.Http.Headers

Représente la valeur de l’en-tête HTTP de connexion sur une requête 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

Héritage

Object Platform::Object IInspectable HttpConnectionOptionHeaderValueCollection

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Implémente

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

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

L’exemple de code suivant montre une méthode permettant d’obtenir et de définir l’en-tête HTTP Connection sur un objet HttpRequestMessage à l’aide des propriétés et méthodes des classes HttpConnectionOptionHeaderValueCollection et 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());
        }

Remarques

HttpConnectionOptionHeaderValueCollection représente la valeur de l’en-tête HTTP connection sur une requête HTTP.

HttpConnectionOptionHeaderValueCollection est une collection d’objets HttpConnectionOptionHeaderValue utilisés pour les informations de connexion sur l’en-tête de connexion HTTP.

La propriété Connection sur httpRequestHeaderCollection renvoie un objet HttpConnectionOptionHeaderValueCollection.

Listes de membres de la collection

Pour JavaScript, HttpConnectionOptionHeaderValueCollection contient les membres affichés dans les listes de membres. En outre, HttpConnectionOptionHeaderValueCollection prend en charge les membres de Array.prototype et l’utilisation d’un index pour accéder aux éléments.

Énumération de la collection en C# ou Microsoft Visual Basic

Vous pouvez itérer au sein d’un objet HttpConnectionOptionHeaderValueCollection en C# ou Microsoft Visual Basic. Dans de nombreux cas, comme l’utilisation de la syntaxe foreach , le compilateur effectue ce cast pour vous et vous n’aurez pas besoin d’effectuer un cast IEnumerable<HttpConnectionOptionHeaderValue> vers explicitement. Si vous avez besoin d’un cast explicite, par exemple si vous souhaitez appeler GetEnumerator, castez l’objet de collection en IEnumerable<T> avec une contrainte HttpConnectionOptionHeaderValue .

Propriétés

Size	Obtient le nombre d’objets HttpConnectionOptionHeaderValue dans la collection.

Méthodes

Append(HttpConnectionOptionHeaderValue)	Ajoute un nouvel élément HttpConnectionOptionHeaderValue à la fin de la collection.
Clear()	Supprime tous les objets HttpConnectionOptionHeaderValue de la collection.
First()	Récupère un itérateur vers le premier élément HttpConnectionOptionHeaderValue de la collection.
GetAt(UInt32)	Renvoie la valeur HttpConnectionOptionHeaderValue à l’index spécifié dans la collection.
GetMany(UInt32, HttpConnectionOptionHeaderValue[])	Récupère les éléments HttpConnectionOptionHeaderValue qui commencent à l’index spécifié dans la collection.
GetView()	Renvoie une vue immuable de l’objet HttpConnectionOptionHeaderValueCollection.
IndexOf(HttpConnectionOptionHeaderValue, UInt32)	Récupère l’index d’un objet HttpConnectionOptionHeaderValue dans la collection.
InsertAt(UInt32, HttpConnectionOptionHeaderValue)	Insère une valeur HttpConnectionOptionHeaderValue dans la collection à l’index spécifié.
ParseAdd(String)	Analyse et ajoute une entrée à l’objet HttpConnectionOptionHeaderValueCollection.
RemoveAt(UInt32)	Supprime l’entrée à l’index spécifié de l’objet HttpConnectionOptionHeaderValueCollection.
RemoveAtEnd()	Supprime le dernier élément HttpConnectionOptionHeaderValue de la collection.
ReplaceAll(HttpConnectionOptionHeaderValue[])	Remplace tous les éléments HttpConnectionOptionHeaderValue de la collection par les éléments HttpConnectionOptionHeaderValue spécifiés.
SetAt(UInt32, HttpConnectionOptionHeaderValue)	Définit httpConnectionOptionHeaderValue à l’index spécifié dans la collection.
ToString()	Renvoie une chaîne qui représente l’objet HttpConnectionOptionHeaderValueCollection actuel.
TryParseAdd(String)	Tente d’analyser et d’ajouter l’élément spécifié à httpConnectionOptionHeaderValueCollection.

Voir aussi

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