http_client::request Method

Asynchronously sends an HTTP request.

_ASYNCRTIMP pplx::task<http_response> request(
   http_request request
);

pplx::task<http_response> request(
   method mtd
);

pplx::task<http_response> request(
   method mtd,
   const utility::string_t &path_query_fragment
);

pplx::task<http_response> request(
   method mtd,
   const utility::string_t &path_query_fragment,
   const json::value &body_data
);

pplx::task<http_response> request(
   method mtd,
   const utility::string_t &path_query_fragment,
   const utility::string_t &body_data,
   utility::string_t content_type = U("text/plain")
);

pplx::task<http_response> request(
   method mtd,
   const utility::string_t &path_query_fragment,
   concurrency::streams::istream body,
   utility::string_t content_type = U("application/octet-stream")
);

pplx::task<http_response> request(
   method mtd,
   const utility::string_t &path_query_fragment,
   concurrency::streams::istream body,
   size_t content_length,
   utility::string_t content_type= U("application/octet-stream")
);

Parameters

• request
  Request to send.

• mtd
  HTTP request method.

• path_query_fragment
  String containing the path, query, and fragment, relative to the http_client's base URI.

• body_data
  String containing the text to use in the message body.

• content_type
  A string holding the MIME type of the message body.

• body
  An asynchronous stream representing the body data.

• content_length
  Size of the message body.

Return Value

An asynchronous operation that is completed once a response from the request is received.

Requirements

Header: http_client.h

Namespace: web::http::client

See Also

Reference

http_client Class