HttpConnectionOptionHeaderValueCollection Classe

Definizione

Spazio dei nomi:

Windows.Web.Http.Headers

Rappresenta il valore dell'intestazione HTTP di connessione in una richiesta 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

Ereditarietà

Object Platform::Object IInspectable HttpConnectionOptionHeaderValueCollection

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Implementazioni

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

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Il codice di esempio seguente mostra un metodo per ottenere e impostare l'intestazione HTTP connection in un oggetto HttpRequestMessage usando le proprietà e i metodi nelle classi 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());
        }

Commenti

HttpConnectionOptionHeaderValueCollection rappresenta il valore dell'intestazione HTTP connessione in una richiesta HTTP.

HttpConnectionOptionHeaderValueCollection è una raccolta di oggetti HttpConnectionOptionHeaderValue usati per le informazioni di connessione nell'intestazione connessione HTTP.

La proprietà Connection in HttpRequestHeaderCollection restituisce un oggetto HttpConnectionOptionHeaderValueCollection.

Elenchi di membri della raccolta

Per JavaScript, HttpConnectionOptionHeaderValueCollection contiene i membri visualizzati negli elenchi di membri. HttpConnectionOptionHeaderValueCollection supporta inoltre i membri di Array.prototype e l'uso di un indice per accedere agli elementi.

Enumerazione della raccolta in C# o Microsoft Visual Basic

È possibile eseguire l'iterazione tramite un oggetto HttpConnectionOptionHeaderValueCollection in C# o Microsoft Visual Basic. In molti casi, ad esempio usando la sintassi foreach , il compilatore esegue questo cast per l'utente e non è necessario eseguire il cast IEnumerable<HttpConnectionOptionHeaderValue> in modo esplicito. Se è necessario eseguire il cast in modo esplicito, ad esempio se si vuole chiamare GetEnumerator, eseguire il cast dell'oggetto raccolta in IEnumerable<T> con un vincolo HttpConnectionOptionHeaderValue .

Proprietà

Size	Ottiene il numero di oggetti HttpConnectionOptionHeaderValue nell'insieme.

Metodi

Append(HttpConnectionOptionHeaderValue)	Aggiunge un nuovo elemento HttpConnectionOptionHeaderValue alla fine dell'insieme.
Clear()	Rimuove tutti gli oggetti HttpConnectionOptionHeaderValue dall'insieme.
First()	Recupera un iteratore al primo elemento HttpConnectionOptionHeaderValue nell'insieme.
GetAt(UInt32)	Restituisce httpConnectionOptionHeaderValue nell'indice specificato nell'insieme.
GetMany(UInt32, HttpConnectionOptionHeaderValue[])	Recupera gli elementi HttpConnectionOptionHeaderValue che iniziano all'indice specificato nella raccolta.
GetView()	Restituisce una visualizzazione non modificabile dell'oggetto HttpConnectionOptionHeaderValueCollection.
IndexOf(HttpConnectionOptionHeaderValue, UInt32)	Recupera l'indice di un valore HttpConnectionOptionHeaderValue nell'insieme.
InsertAt(UInt32, HttpConnectionOptionHeaderValue)	Inserisce un valore HttpConnectionOptionHeaderValue nell'insieme in corrispondenza dell'indice specificato.
ParseAdd(String)	Analizza e aggiunge una voce a HttpConnectionOptionHeaderValueCollection.
RemoveAt(UInt32)	Rimuove la voce in corrispondenza dell'indice specificato da HttpConnectionOptionHeaderValueCollection.
RemoveAtEnd()	Rimuove l'ultimo elemento HttpConnectionOptionHeaderValue dall'insieme.
ReplaceAll(HttpConnectionOptionHeaderValue[])	Sostituisce tutti gli elementi HttpConnectionOptionHeaderValue nella raccolta con gli elementi HttpConnectionOptionHeaderValue specificati.
SetAt(UInt32, HttpConnectionOptionHeaderValue)	Imposta HttpConnectionOptionHeaderValue nell'indice specificato nell'insieme.
ToString()	Restituisce una stringa che rappresenta l'oggetto HttpConnectionOptionHeaderValueCollection corrente.
TryParseAdd(String)	Tenta di analizzare e aggiungere l'elemento specificato all'oggetto HttpConnectionOptionHeaderValueCollection.

Vedi anche

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