HttpRequestMessage Класс

  • Ссылка

Определение

Пространство имен:
Windows.Web.Http
Изменить

Представляет сообщение HTTP-запроса, включая заголовки.

public ref class HttpRequestMessage sealed : IClosable, IStringable
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.Http.IHttpRequestMessageFactory, 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 HttpRequestMessage final : IClosable, 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(Windows.Web.Http.IHttpRequestMessageFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class HttpRequestMessage final : IClosable, IStringable
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Web.Http.IHttpRequestMessageFactory), 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 HttpRequestMessage : System.IDisposable, 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(typeof(Windows.Web.Http.IHttpRequestMessageFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpRequestMessage : System.IDisposable, IStringable
function HttpRequestMessage(method, uri)
Public NotInheritable Class HttpRequestMessage
Implements IDisposable, IStringable
Наследование
Object Platform::Object IInspectable HttpRequestMessage
Атрибуты
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute
Реализации
IClosable IDisposable IStringable

Требования к Windows

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

Комментарии

Класс HttpRequestMessage содержит заголовки, HTTP-команду и потенциально данные. Этот класс обычно используется разработчиками, которым требуется дополнительный контроль над HTTP-запросами. Ниже приведены распространенные примеры.

  • Проверка базовых сведений о транспорте SSL/TLS.
  • Использование менее распространенного метода HTTP.
  • Чтобы явно задать свойства запроса в httpRequestMessage.

В таких случаях приложение использует один из конструкторов HttpRequestMessage для создания экземпляра HttpRequestMessage. При необходимости приложение задает различные свойства в HttpRequestMessage. Затем HttpRequestMessage передается в качестве параметра одному из методов HttpClient.SendRequestAsync .

Ряд удобных методов класса HttpClient автоматически создает объект HttpRequestMessage для приложения. К этим методам относятся следующие:

Все фильтры, добавленные в конвейер фильтров, будут переданы объекту HttpRequestMessage независимо от того, был ли он явно указан приложением или был автоматически создан для вас.

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

HttpRequestMessage()

Инициализирует новый экземпляр класса HttpRequestMessage .
HttpRequestMessage(HttpMethod, Uri)

Инициализирует новый экземпляр класса HttpRequestMessage с помощью метода HTTP и URI запроса.

Свойства

Content

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

Возвращает коллекцию заголовков HTTP-запросов, связанных с HttpRequestMessage.
Method

Возвращает или задает метод HTTP, выполняемый по URI запроса.
PrivacyAnnotation

Представляет сообщение HTTP-запроса, включая заголовки.
Properties

Возвращает набор свойств экземпляра HttpRequestMessage , которые используются разработчиком.
RequestUri

Возвращает или задает универсальный код ресурса (URI), используемый для объекта HttpRequestMessage .
TransportInformation

Получение сведений о базовом транспортном сокете, используемом HTTP-подключением.

Методы

Close()

Закрывает экземпляр HttpRequestMessage и освобождает выделенные ресурсы.
Dispose()

Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов.
ToString()

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

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

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