HttpContentHeaderCollection Класс

Определение

Предоставляет коллекцию заголовков HTTP, связанных с содержимым в HTTP-запросе или ответе.

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
Наследование
Object Platform::Object IInspectable HttpContentHeaderCollection
Атрибуты
Реализации
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

Семейство устройств
Windows 10 (появилось в 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

В следующем примере кода показан метод для получения и задания заголовков для содержимого HTTP с помощью свойств объекта HttpContentHeaderCollection . Пространство имен Windows.Web.Http.Headers содержит ряд строго типизированных коллекций заголовков и классов значений для определенных http-заголовков, которые можно использовать для получения и задания заголовков с проверкой.

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

Комментарии

HttpContentHeaderCollection — это коллекция заголовков HTTP, связанных с содержимым HTTP в HTTP-запросе или ответном сообщении HTTP. Объект HttpContentHeaderCollection можно использовать для получения или задания определенных заголовков в содержимом HTTP. Большинство свойств объекта HttpContentHeaderCollection предоставляют доступ к коллекции контейнеров для определенного заголовка HTTP.

HttpContentHeaderCollection имеет конструктор, а также возвращается свойством для классов HttpBufferContent, HttpFormUrlEncodedContent, HttpMultipartContent, HttpMultipartFormDataContent, HttpStreamContent и HttpStringContent, а также интерфейса IHttpContent.

Перечисление коллекции на C# или Microsoft Visual Basic

Вы можете выполнить итерацию по объекту HttpContentHeaderCollection в C# или Microsoft Visual Basic. Во многих случаях, например с помощью синтаксиса foreach , компилятор выполняет это приведение за вас, и вам не нужно выполнять приведение IEnumerable явно. Если необходимо выполнить приведение явным образом, например, если вы хотите вызвать GetEnumerator, приведите объект коллекции к IEnumerable<T> с параметром KeyValuePairstring и String в качестве ограничения.

Конструкторы

HttpContentHeaderCollection()

Инициализирует новый экземпляр класса HttpContentHeaderCollection .

Свойства

ContentDisposition

Возвращает или задает объект HttpContentDispositionHeaderValue , представляющий значение заголовка HTTP Content-Disposition для содержимого HTTP.

ContentEncoding

Возвращает httpContentCodingHeaderValueCollection объектов HttpContentCodingHeaderValue , представляющих значение заголовка HTTP Content-Encoding в http-содержимом .

ContentLanguage

Возвращает httpLanguageHeaderValueCollection объектов, представляющих значение заголовка HTTP Content-Language для содержимого HTTP.

ContentLength

Возвращает или задает значение заголовка HTTP Content-Length для содержимого HTTP.

ContentLocation

Возвращает или задает значение заголовка HTTP Content-Location для содержимого HTTP.

ContentMD5

Возвращает или задает значение заголовка HTTP Content-MD5 для содержимого HTTP.

ContentRange

Возвращает или задает объект HttpContentRangeHeaderValue , представляющий значение заголовка Content-Range http для содержимого HTTP.

ContentType

Возвращает или задает объект HttpMediaTypeHeaderValue , представляющий значение заголовка Content-Type HTTP для содержимого HTTP.

Expires

Возвращает или задает объект DateTime , представляющий значение заголовка HTTP Expires в содержимом HTTP.

LastModified

Возвращает или задает объект DateTime , представляющий значение заголовка HTTP Last-Modified в содержимом HTTP.

Size

Возвращает количество объектов в коллекции HttpContentHeaderCollection.

Методы

Append(String, String)

Добавляет новый элемент в конец httpContentHeaderCollection.

Clear()

Удаляет все объекты из коллекции HttpContentHeaderCollection.

First()

Извлекает итератор к первому элементу в httpContentHeaderCollection.

GetView()

Возвращает неизменяемое представление объекта HttpContentHeaderCollection.

HasKey(String)

Определяет, содержит ли httpContentHeaderCollection указанный ключ.

Insert(String, String)

Вставляет или заменяет элемент в коллекции HttpContentHeaderCollection указанным ключом и значением.

Lookup(String)

Находит элемент в httpContentHeaderCollection , если он существует.

Remove(String)

Удаляет определенный объект из коллекции HttpContentHeaderCollection.

ToString()

Возвращает строку, представляющую текущий объект HttpContentHeaderCollection .

TryAppendWithoutValidation(String, String)

Попробуйте добавить указанный элемент в коллекцию HttpContentHeaderCollection без проверки.

Применяется к

См. также раздел