Freigeben über


HttpContentHeaderCollection Klasse

Definition

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

Gilt für:

Weitere Informationen