HttpContentHeaderCollection Classe

Définition

Espace de noms:

Windows.Web.Http.Headers

Fournit une collection des en-têtes HTTP associés au contenu d’une requête ou d’une réponse 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

Héritage

Object Platform::Object IInspectable HttpContentHeaderCollection

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

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

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 des en-têtes sur du contenu HTTP à l’aide des propriétés de l’objet HttpContentHeaderCollection . L’espace de noms Windows.Web.Http.Headers a un certain nombre de collections d’en-têtes et de classes de valeur fortement typées pour des en-têtes HTTP spécifiques qui peuvent être utilisées pour obtenir et définir des en-têtes avec validation.

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());
}

Remarques

HttpContentHeaderCollection est une collection d’en-têtes HTTP associés au contenu HTTP sur une requête HTTP ou un message de réponse HTTP. L’objet HttpContentHeaderCollection peut être utilisé pour obtenir ou définir les en-têtes spécifiques sur le contenu HTTP. La plupart des propriétés de l’objet HttpContentHeaderCollection fournissent l’accès à une collection de conteneurs pour un en-tête HTTP spécifique.

HttpContentHeaderCollection a un constructeur et est également retourné par la propriété sur HttpBufferContent, HttpFormUrlEncodedContent, HttpMultipartContent, HttpMultipartFormDataContent, HttpStreamContent et HttpStringContent, les classes et l’interface IHttpContent.

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

Vous pouvez itérer au sein d’un objet HttpContentHeaderCollection 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 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 un KeyValuePair de String et string comme contrainte.

Constructeurs

HttpContentHeaderCollection()

Initialise une nouvelle instance de la classe HttpContentHeaderCollection.

Propriétés

ContentDisposition	Obtient ou définit l’objet HttpContentDispositionHeaderValue qui représente la valeur d’un en-tête HTTP Content-Disposition sur le contenu HTTP.
ContentEncoding	Obtient le HttpContentCodingHeaderValueCollection des objets HttpContentCodingHeaderValue qui représentent la valeur d’un en-tête HTTP Content-Encoding sur le contenu HTTP.
ContentLanguage	Obtient le HttpLanguageHeaderValueCollection des objets qui représentent la valeur d’un en-tête HTTP Content-Language sur le contenu HTTP.
ContentLength	Obtient ou définit la valeur de l’en-tête HTTP Content-Length sur le contenu HTTP.
ContentLocation	Obtient ou définit la valeur de l’en-tête HTTP Content-Location sur le contenu HTTP.
ContentMD5	Obtient ou définit la valeur d’un en-tête HTTP Content-MD5 sur le contenu HTTP.
ContentRange	Obtient ou définit l’objet HttpContentRangeHeaderValue qui représente la valeur d’un en-tête HTTP Content-Range sur le contenu HTTP.
ContentType	Obtient ou définit l’objet HttpMediaTypeHeaderValue qui représente la valeur d’un en-tête HTTP Content-Type sur le contenu HTTP.
Expires	Obtient ou définit l’objet DateTime qui représente la valeur d’un en-tête HTTP Expires sur le contenu HTTP.
LastModified	Obtient ou définit l’objet DateTime qui représente la valeur d’un en-tête HTTP Last-Modified sur le contenu HTTP.
Size	Obtient le nombre d’objets dans httpContentHeaderCollection.

Méthodes

Append(String, String)	Ajoute un nouvel élément à la fin de httpContentHeaderCollection.
Clear()	Supprime tous les objets du HttpContentHeaderCollection.
First()	Récupère un itérateur vers le premier élément du HttpContentHeaderCollection.
GetView()	Renvoie une vue immuable de httpContentHeaderCollection.
HasKey(String)	Détermine si httpContentHeaderCollection contient la clé spécifiée.
Insert(String, String)	Insère ou remplace un élément dans httpContentHeaderCollection par la clé et la valeur spécifiées.
Lookup(String)	Recherche un élément dans httpContentHeaderCollection s’il existe.
Remove(String)	Supprime un objet spécifique du HttpContentHeaderCollection.
ToString()	Renvoie une chaîne qui représente l’objet HttpContentHeaderCollection actuel.
TryAppendWithoutValidation(String, String)	Essayez d’ajouter l’élément spécifié à httpContentHeaderCollection sans validation.

Voir aussi

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