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
- Наследование
- Атрибуты
- Реализации
-
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 без проверки. |