HttpClient.PutAsync Método

Definição

Espaço de Nomes:: System.Net.Http

Assemblagem:: System.Net.Http.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Envie um pedido PUT para o URI especificado como uma operação assíncrona.

Sobrecargas

Name	Description
PutAsync(String, HttpContent)	Envie um pedido PUT para o URI especificado como uma operação assíncrona.
PutAsync(Uri, HttpContent)	Envie um pedido PUT para o URI especificado como uma operação assíncrona.
PutAsync(String, HttpContent, CancellationToken)	Enviar um pedido PUT com um token de cancelamento como uma operação assíncrona.
PutAsync(Uri, HttpContent, CancellationToken)	Enviar um pedido PUT com um token de cancelamento como uma operação assíncrona.

Observações

Esta operação não bloqueia.

PutAsync(String, HttpContent)

Envie um pedido PUT para o URI especificado como uma operação assíncrona.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync(string requestUri, System.Net.Http.HttpContent content);

member this.PutAsync : string * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function PutAsync (requestUri As String, content As HttpContent) As Task(Of HttpResponseMessage)

Parâmetros

requestUri: String

O URI para onde o pedido é enviado.

content: HttpContent

O conteúdo do pedido HTTP enviado para o servidor.

Devoluções

Task<HttpResponseMessage>

O objeto tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

Não requestUri é um URI absoluto e BaseAddress não está configurado.

HttpRequestException

O pedido falhou devido a um problema em obter uma resposta HTTP válida, como falha de conectividade de rede, falha DNS, erro de validação de certificado do servidor ou resposta inválida do servidor. Em versões .NET 8 e posteriores, a razão é indicada por HttpRequestError

-ou-

Framework .NET apenas: O pedido expirou.

OperationCanceledException

.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.

UriFormatException

O URI de pedido fornecido não é válido relativo nem absoluto.

Observações

Esta operação não bloqueia. O objeto devolvido Task<TResult> será concluído depois de toda a resposta (incluindo o conteúdo) ser lida.

Note

Em caso de timeout, diferentes exceções são lançadas em diferentes implementações .NET.

HttpRequestException está incluído em todas as versões aplicáveis do .NET Framework.
OperationCanceledException sem exceção interna é aplicado em todas as versões .NET Core aplicáveis.
OperationCanceledException que aninham um TimeoutException é lançado em .NET versões 5 e posteriores.

Aplica-se a

PutAsync(Uri, HttpContent)

Envie um pedido PUT para o URI especificado como uma operação assíncrona.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync(Uri requestUri, System.Net.Http.HttpContent content);

member this.PutAsync : Uri * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function PutAsync (requestUri As Uri, content As HttpContent) As Task(Of HttpResponseMessage)

Parâmetros

requestUri: Uri

O URI para onde o pedido é enviado.

content: HttpContent

O conteúdo do pedido HTTP enviado para o servidor.

Devoluções

Task<HttpResponseMessage>

O objeto tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

Não requestUri é um URI absoluto e BaseAddress não está configurado.

HttpRequestException

-ou-

Framework .NET apenas: O pedido expirou.

OperationCanceledException

.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.

Observações

Esta operação não bloqueia. O objeto devolvido Task<TResult> será concluído depois de toda a resposta (incluindo o conteúdo) ser lida.

Note

Em caso de timeout, diferentes exceções são lançadas em diferentes implementações .NET.

HttpRequestException está incluído em todas as versões aplicáveis do .NET Framework.
OperationCanceledException sem exceção interna é aplicado em todas as versões .NET Core aplicáveis.
OperationCanceledException que aninham um TimeoutException é lançado em .NET versões 5 e posteriores.

Aplica-se a

PutAsync(String, HttpContent, CancellationToken)

Enviar um pedido PUT com um token de cancelamento como uma operação assíncrona.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync(string requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);

member this.PutAsync : string * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function PutAsync (requestUri As String, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parâmetros

requestUri: String

O URI para onde o pedido é enviado.

content: HttpContent

O conteúdo do pedido HTTP enviado para o servidor.

cancellationToken: CancellationToken

Um token de cancelamento que pode ser usado por outros objetos ou threads para receber aviso de cancelamento.

Devoluções

Task<HttpResponseMessage>

O objeto tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

Não requestUri é um URI absoluto e BaseAddress não está configurado.

HttpRequestException

-ou-

Framework .NET apenas: O pedido expirou.

UriFormatException

O URI de pedido fornecido não é válido relativo nem absoluto.

OperationCanceledException

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

-ou-

.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.

Observações

Esta operação não bloqueia. O objeto devolvido Task<TResult> será concluído depois de toda a resposta (incluindo o conteúdo) ser lida.

Note

Em caso de timeout, diferentes exceções são lançadas em diferentes implementações .NET.

HttpRequestException está incluído em todas as versões aplicáveis do .NET Framework.
OperationCanceledException sem exceção interna é aplicado em todas as versões .NET Core aplicáveis.
OperationCanceledException que aninham um TimeoutException é lançado em .NET versões 5 e posteriores.

Aplica-se a

PutAsync(Uri, HttpContent, CancellationToken)

Enviar um pedido PUT com um token de cancelamento como uma operação assíncrona.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync(Uri requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);

member this.PutAsync : Uri * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function PutAsync (requestUri As Uri, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parâmetros

requestUri: Uri

O URI para onde o pedido é enviado.

content: HttpContent

O conteúdo do pedido HTTP enviado para o servidor.

cancellationToken: CancellationToken

Um token de cancelamento que pode ser usado por outros objetos ou threads para receber aviso de cancelamento.

Devoluções

Task<HttpResponseMessage>

O objeto tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

Não requestUri é um URI absoluto e BaseAddress não está configurado.

HttpRequestException

-ou-

Framework .NET apenas: O pedido expirou.

OperationCanceledException

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

-ou-

.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.

Observações

Esta operação não bloqueia. O objeto devolvido Task<TResult> será concluído depois de toda a resposta (incluindo o conteúdo) ser lida.

Note

Em caso de timeout, diferentes exceções são lançadas em diferentes implementações .NET.

HttpRequestException está incluído em todas as versões aplicáveis do .NET Framework.
OperationCanceledException sem exceção interna é aplicado em todas as versões .NET Core aplicáveis.
OperationCanceledException que aninham um TimeoutException é lançado em .NET versões 5 e posteriores.

Aplica-se a

Comentários

Esta página foi útil?