HttpContentHeaderCollection Klasse

Definition

Namespace:

Windows.Web.Http.Headers

Stellt eine Auflistung der HTTP-Header bereit, die inhalten einer HTTP-Anforderung oder -Antwort zugeordnet sind.

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

Vererbung

Object Platform::Object IInspectable HttpContentHeaderCollection

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

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

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Der folgende Beispielcode zeigt eine Methode zum Abrufen und Festlegen von Headern für HTTP-Inhalte mithilfe der Eigenschaften des HttpContentHeaderCollection-Objekts . Der Windows.Web.Http.Headers-Namespace verfügt über eine Reihe von stark typisierten Headersammlungen und Wertklassen für bestimmte HTTP-Header, die zum Abrufen und Festlegen von Headern mit Validierung verwendet werden können.

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

Hinweise

Die HttpContentHeaderCollection ist eine Sammlung der HTTP-Header, die dem HTTP-Inhalt einer HTTP-Anforderung oder einer HTTP-Antwortnachricht zugeordnet sind. Das HttpContentHeaderCollection-Objekt kann verwendet werden, um die spezifischen Header für den HTTP-Inhalt abzurufen oder festzulegen. Die meisten Eigenschaften des HttpContentHeaderCollection-Objekts bieten Zugriff auf eine Containerauflistung für einen bestimmten HTTP-Header.

Die HttpContentHeaderCollection verfügt über einen Konstruktor und wird auch von der -Eigenschaft für httpBufferContent, HttpFormUrlEncodedContent, HttpMultipartContent, HttpMultipartFormDataContent, HttpStreamContent und HttpStringContent, klassen und die IHttpContent-Schnittstelle zurückgegeben.

Auflisten der Sammlung in C# oder Microsoft Visual Basic

Sie können ein HttpContentHeaderCollection-Objekt in C# oder Microsoft Visual Basic durchlaufen. In vielen Fällen, z. B. mit foreach-Syntax , führt der Compiler diese Umwandlung für Sie durch, und Sie müssen nicht explizit in IEnumerable umwandeln. Wenn Sie eine explizite Umwandlung durchführen müssen, z. B. wenn Sie GetEnumerator aufrufen möchten, wandeln Sie das Auflistungsobjekt in IEnumerable<T> mit einem KeyValuePair-Wert von String und String als Einschränkung um.

Konstruktoren

HttpContentHeaderCollection()

Initialisiert eine neue instance der HttpContentHeaderCollection-Klasse.

Eigenschaften

ContentDisposition	Ruft das HttpContentDispositionHeaderValue-Objekt ab, das den Wert eines HTTP Content-Disposition-Headers für den HTTP-Inhalt darstellt, oder legt dieses fest.
ContentEncoding	Ruft die HttpContentCodingHeaderValueCollection von HttpContentCodingHeaderValue-Objekten ab, die den Wert eines HTTP Content-Encoding-Headers für den HTTP-Inhalt darstellen.
ContentLanguage	Ruft die HttpLanguageHeaderValueCollection von Objekten ab, die den Wert eines HTTP Content-Language-Headers für den HTTP-Inhalt darstellen.
ContentLength	Ruft den Wert des HTTP Content-Length-Headers für den HTTP-Inhalt ab oder legt den Wert fest.
ContentLocation	Ruft den Wert des HTTP Content-Location-Headers für den HTTP-Inhalt ab oder legt den Wert fest.
ContentMD5	Ruft den Wert eines HTTP Content-MD5-Headers für den HTTP-Inhalt ab oder legt diesen fest.
ContentRange	Ruft das HttpContentRangeHeaderValue-Objekt ab, das den Wert eines HTTP Content-Range-Headers für den HTTP-Inhalt darstellt, oder legt dieses fest.
ContentType	Ruft das HttpMediaTypeHeaderValue-Objekt ab, das den Wert eines HTTP Content-Type-Headers für den HTTP-Inhalt darstellt, oder legt dieses fest.
Expires	Ruft das DateTime-Objekt ab, das den Wert eines HTTP Expires-Headers für den HTTP-Inhalt darstellt, oder legt es fest.
LastModified	Ruft das DateTime-Objekt ab, das den Wert eines HTTP Last-Modified-Headers für den HTTP-Inhalt darstellt, oder legt es fest.
Size	Ruft die Anzahl der Objekte in HttpContentHeaderCollection ab.

Methoden

Append(String, String)	Fügt am Ende der HttpContentHeaderCollection ein neues Element hinzu.
Clear()	Entfernt alle Objekte aus der HttpContentHeaderCollection.
First()	Ruft einen Iterator zum ersten Element in der HttpContentHeaderCollection ab.
GetView()	Gibt eine unveränderliche Ansicht der HttpContentHeaderCollection zurück.
HasKey(String)	Bestimmt, ob die HttpContentHeaderCollection den angegebenen Schlüssel enthält.
Insert(String, String)	Fügt ein Element in der HttpContentHeaderCollection ein oder ersetzt es durch den angegebenen Schlüssel und Wert.
Lookup(String)	Sucht ein Element in der HttpContentHeaderCollection , sofern vorhanden.
Remove(String)	Entfernt ein bestimmtes Objekt aus der HttpContentHeaderCollection.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle HttpContentHeaderCollection-Objekt darstellt.
TryAppendWithoutValidation(String, String)	Versuchen Sie, das angegebene Element ohne Validierung an httpContentHeaderCollection anzufügen.

Weitere Informationen

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