Comparteix a través de


HttpClient.PostAsync Método

Definición

Envía una solicitud POST al URI especificado como una operación asincrónica.

Sobrecargas

PostAsync(String, HttpContent, CancellationToken)

Envía una solicitud POST con un token de cancelación como una operación asincrónica.

PostAsync(Uri, HttpContent, CancellationToken)

Envía una solicitud POST con un token de cancelación como una operación asincrónica.

PostAsync(String, HttpContent)

Envía una solicitud POST al URI especificado como una operación asincrónica.

PostAsync(Uri, HttpContent)

Envía una solicitud POST al URI especificado como una operación asincrónica.

Comentarios

Esta operación no se bloqueará.

PostAsync(String, HttpContent, CancellationToken)

Source:
HttpClient.cs
Source:
HttpClient.cs
Source:
HttpClient.cs

Envía una solicitud POST con un token de cancelación como una operación asincrónica.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent? content, System.Threading.CancellationToken cancellationToken);
member this.PostAsync : string * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function PostAsync (requestUri As String, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parámetros

requestUri
String

URI al que se envía la solicitud.

content
HttpContent

Contenido de la solicitud HTTP que se envía al servidor.

cancellationToken
CancellationToken

Token de cancelación que pueden usar otros objetos o subprocesos para recibir el aviso de cancelación.

Devoluciones

Objeto de tarea que representa la operación asincrónica.

Excepciones

requestUri debe ser un URI absoluto o se debe establecer BaseAddress.

Error en la solicitud debido a un problema subyacente, como la conectividad de red, un error de DNS, la validación del certificado de servidor o el tiempo de espera.

Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.

El URI de solicitud proporcionado no es un URI relativo o absoluto válido.

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Esta operación no se bloqueará. El objeto devuelto Task<TResult> se completará después de leer toda la respuesta (incluido el contenido).

Nota

En el caso del tiempo de espera, se producen excepciones diferentes en diferentes implementaciones de .NET.

Se aplica a

PostAsync(Uri, HttpContent, CancellationToken)

Source:
HttpClient.cs
Source:
HttpClient.cs
Source:
HttpClient.cs

Envía una solicitud POST con un token de cancelación como una operación asincrónica.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent? content, System.Threading.CancellationToken cancellationToken);
member this.PostAsync : Uri * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function PostAsync (requestUri As Uri, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parámetros

requestUri
Uri

URI al que se envía la solicitud.

content
HttpContent

Contenido de la solicitud HTTP que se envía al servidor.

cancellationToken
CancellationToken

Token de cancelación que pueden usar otros objetos o subprocesos para recibir el aviso de cancelación.

Devoluciones

Objeto de tarea que representa la operación asincrónica.

Excepciones

requestUri debe ser un URI absoluto o se debe establecer BaseAddress.

Error en la solicitud debido a un problema subyacente, como la conectividad de red, un error de DNS, la validación del certificado de servidor o el tiempo de espera.

Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Esta operación no se bloqueará. El objeto devuelto Task<TResult> se completará después de leer toda la respuesta (incluido el contenido).

Nota

En el caso del tiempo de espera, se producen excepciones diferentes en diferentes implementaciones de .NET.

Se aplica a

PostAsync(String, HttpContent)

Source:
HttpClient.cs
Source:
HttpClient.cs
Source:
HttpClient.cs

Envía una solicitud POST al URI especificado como una operación asincrónica.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string requestUri, System.Net.Http.HttpContent content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent? content);
member this.PostAsync : string * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function PostAsync (requestUri As String, content As HttpContent) As Task(Of HttpResponseMessage)

Parámetros

requestUri
String

URI al que se envía la solicitud.

content
HttpContent

Contenido de la solicitud HTTP que se envía al servidor.

Devoluciones

Objeto de tarea que representa la operación asincrónica.

Excepciones

requestUri debe ser un URI absoluto o se debe establecer BaseAddress.

Error en la solicitud debido a un problema subyacente, como la conectividad de red, un error de DNS, la validación del certificado de servidor o el tiempo de espera.

Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.

El URI de solicitud proporcionado no es un URI relativo o absoluto válido.

Comentarios

Esta operación no se bloqueará. El objeto devuelto Task<TResult> se completará después de leer toda la respuesta (incluido el contenido).

Nota

En el caso del tiempo de espera, se producen excepciones diferentes en diferentes implementaciones de .NET.

Se aplica a

PostAsync(Uri, HttpContent)

Source:
HttpClient.cs
Source:
HttpClient.cs
Source:
HttpClient.cs

Envía una solicitud POST al URI especificado como una operación asincrónica.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri requestUri, System.Net.Http.HttpContent content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent? content);
member this.PostAsync : Uri * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function PostAsync (requestUri As Uri, content As HttpContent) As Task(Of HttpResponseMessage)

Parámetros

requestUri
Uri

URI al que se envía la solicitud.

content
HttpContent

Contenido de la solicitud HTTP que se envía al servidor.

Devoluciones

Objeto de tarea que representa la operación asincrónica.

Excepciones

requestUri debe ser un URI absoluto o se debe establecer BaseAddress.

Error en la solicitud debido a un problema subyacente, como la conectividad de red, un error de DNS, la validación del certificado de servidor o el tiempo de espera.

Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.

Comentarios

Esta operación no se bloqueará. El objeto devuelto Task<TResult> se completará después de leer toda la respuesta (incluido el contenido).

Nota

En el caso del tiempo de espera, se producen excepciones diferentes en diferentes implementaciones de .NET.

Se aplica a