HttpContentHeaderCollection Classe

Definizione

Spazio dei nomi:

Windows.Web.Http.Headers

Fornisce una raccolta di intestazioni HTTP associate al contenuto in una richiesta o una risposta HTTP.

public ref class HttpContentHeaderCollection sealed : IIterable<IKeyValuePair<Platform::String ^, Platform::String ^> ^>, IMap<Platform::String ^, Platform::String ^>, 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)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class HttpContentHeaderCollection final : IIterable<IKeyValuePair<winrt::hstring, winrt::hstring const&>>, IMap<winrt::hstring, winrt::hstring const&>, 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)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpContentHeaderCollection : IDictionary<string,string>, IEnumerable<KeyValuePair<string,string>>, IStringable

function HttpContentHeaderCollection()

Public NotInheritable Class HttpContentHeaderCollection
Implements IDictionary(Of String, String), IEnumerable(Of KeyValuePair(Of String, String)), IStringable

Ereditarietà

Object Platform::Object IInspectable HttpContentHeaderCollection

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

IMap<String,String> IDictionary<String,String> IMap<Platform::String,Platform::String> IMap<winrt::hstring,winrt::hstring> IIterable<IKeyValuePair<K,V>> IEnumerable<KeyValuePair<K,V>> IIterable<IKeyValuePair<String,String>> IEnumerable<KeyValuePair<String,String>> IIterable<IKeyValuePair<Platform::String,Platform::String>> IIterable<IKeyValuePair<winrt::hstring,winrt::hstring>> 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 intestazioni nel contenuto HTTP usando le proprietà nell'oggetto HttpContentHeaderCollection . Lo spazio dei nomi Windows.Web.Http.Headers include una serie di classi di intestazioni e valori fortemente tipizzata per intestazioni HTTP specifiche che possono essere usate per ottenere e impostare intestazioni con convalida.

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

public void DemonstrateContentHeader()
{
    DemonstrateHeaderContentContentDisposition();
}

public void DemonstrateHeaderContentContentDisposition()
{
    var content = new HttpStringContent("");
    bool parsedOk = false;

    // Set the header with a string.
    HttpContentDispositionHeaderValue value;
    parsedOk = HttpContentDispositionHeaderValue.TryParse("attachment; filename=\"fname.ext\"", out value);
    content.Headers.ContentDisposition = value;

    // Set the header with a strong type.

    content.Headers.ContentDisposition = new HttpContentDispositionHeaderValue("attachment");
    content.Headers.ContentDisposition.FileName = "myfile.exe";


    // Get the strong type out
    System.Diagnostics.Debug.WriteLine("ContentDisposition filename: {0}={1}",
        content.Headers.ContentDisposition.DispositionType,
        content.Headers.ContentDisposition.FileName);

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

Commenti

HttpContentHeaderCollection è una raccolta di intestazioni HTTP associate al contenuto HTTP in una richiesta HTTP o in un messaggio di risposta HTTP. L'oggetto HttpContentHeaderCollection può essere usato per ottenere o impostare le intestazioni specifiche nel contenuto HTTP. La maggior parte delle proprietà nell'oggetto HttpContentHeaderCollection fornisce l'accesso a una raccolta di contenitori per un'intestazione HTTP specifica.

HttpContentHeaderCollection ha un costruttore e viene restituito anche dalla proprietà in HttpBufferContent, HttpFormUrlEncodedContent, HttpMultipartContent, HttpMultipartFormDataContent, HttpStreamContent e HttpStringContent, classi e interfaccia IHttpContent.

Enumerazione della raccolta in C# o Microsoft Visual Basic

È possibile eseguire l'iterazione tramite un oggetto HttpContentHeaderCollection 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 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 valore KeyValuePair di String e String come vincolo.

Costruttori

HttpContentHeaderCollection()

Inizializza una nuova istanza della classe HttpContentHeaderCollection .

Proprietà

ContentDisposition	Ottiene o imposta l'oggetto HttpContentDispositionHeaderValue che rappresenta il valore di un'intestazione HTTP Content-Disposition nel contenuto HTTP.
ContentEncoding	Ottiene gli oggetti HttpContentCodingHeaderValueCollection di HttpContentCodingHeaderValue che rappresentano il valore di un'intestazione di codifica contenuto HTTP nel contenuto HTTP.
ContentLanguage	Ottiene httpLanguageHeaderValueCollection di oggetti che rappresentano il valore di un'intestazione HTTP Content-Language nel contenuto HTTP.
ContentLength	Ottiene o imposta il valore dell'intestazione HTTP Content-Length nel contenuto HTTP.
ContentLocation	Ottiene o imposta il valore dell'intestazione HTTP Content-Location nel contenuto HTTP.
ContentMD5	Ottiene o imposta il valore di un'intestazione HTTP Content-MD5 nel contenuto HTTP.
ContentRange	Ottiene o imposta l'oggetto HttpContentRangeHeaderValue che rappresenta il valore di un'intestazione HTTP Content-Range nel contenuto HTTP.
ContentType	Ottiene o imposta l'oggetto HttpMediaTypeHeaderValue che rappresenta il valore di un'intestazione del tipo di contenuto HTTP nel contenuto HTTP.
Expires	Ottiene o imposta l'oggetto DateTime che rappresenta il valore di un'intestazione DI scadenza HTTP nel contenuto HTTP.
LastModified	Ottiene o imposta l'oggetto DateTime che rappresenta il valore di un'intestazione HTTP Last-Modified nel contenuto HTTP.
Size	Ottiene il numero di oggetti in HttpContentHeaderCollection.

Metodi

Append(String, String)	Aggiunge un nuovo elemento alla fine di HttpContentHeaderCollection.
Clear()	Rimuove tutti gli oggetti da HttpContentHeaderCollection.
First()	Recupera un iteratore al primo elemento in HttpContentHeaderCollection.
GetView()	Restituisce una visualizzazione non modificabile di HttpContentHeaderCollection.
HasKey(String)	Determina se httpContentHeaderCollection contiene la chiave specificata.
Insert(String, String)	Inserisce o sostituisce un elemento in HttpContentHeaderCollection con la chiave e il valore specificati.
Lookup(String)	Trova un elemento in HttpContentHeaderCollection se presente.
Remove(String)	Rimuove un oggetto specifico da HttpContentHeaderCollection.
ToString()	Restituisce una stringa che rappresenta l'oggetto HttpContentHeaderCollection corrente.
TryAppendWithoutValidation(String, String)	Provare ad aggiungere l'elemento specificato all'oggetto HttpContentHeaderCollection senza convalida.

Vedi anche

• HttpBufferContent
• HttpFormUrlEncodedContent
• HttpMultipartContent
• HttpMultipartFormDataContent
• HttpRequestMessage
• HttpResponseMessage
• HttpStreamContent
• HttpStringContent
• IMap<K,V>
• IIterable<T>
• IStringable