HttpClient.PutAsync Método

Referência

Definição

Namespace:: System.Net.Http

Assembly:: System.Net.Http.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Sobrecargas

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

Comentários

Esta operação não será bloqueada.

PutAsync(String, HttpContent)

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Envie uma solicitação 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);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (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 ao qual a solicitação é enviada.

content: HttpContent

O conteúdo da solicitação HTTP enviada ao servidor.

Retornos

Task<HttpResponseMessage>

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

Exceções

InvalidOperationException

O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.

HttpRequestException

A solicitação falhou devido a um problema subjacente, como conectividade de rede, falha de DNS, validação de certificado do servidor ou tempo limite.

TaskCanceledException

Somente .NET Core e .NET 5 e posterior: a solicitação falhou devido ao tempo limite.

UriFormatException

O URI de solicitação fornecido não é um URI relativo ou absoluto válido.

Comentários

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

Observação

No caso de tempo limite, exceções diferentes são geradas em diferentes implementações do .NET.

HttpRequestExceptioné lançado em todas as versões de .NET Framework aplicáveis.
TaskCanceledException sem nenhuma exceção interna é gerada em todas as versões aplicáveis do .NET Core.
TaskCanceledException que aninha um TimeoutException é lançado no .NET 5 e em versões posteriores.

Aplica-se a

PutAsync(Uri, HttpContent)

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Envie uma solicitação 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);

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 ao qual a solicitação é enviada.

content: HttpContent

O conteúdo da solicitação HTTP enviada ao servidor.

Retornos

Task<HttpResponseMessage>

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

Exceções

InvalidOperationException

O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.

HttpRequestException

A solicitação falhou devido a um problema subjacente, como conectividade de rede, falha de DNS, validação de certificado do servidor ou tempo limite.

TaskCanceledException

Somente .NET Core e .NET 5 e posterior: a solicitação falhou devido ao tempo limite.

Comentários

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

Observação

No caso de tempo limite, exceções diferentes são geradas em diferentes implementações do .NET.

HttpRequestExceptioné lançado em todas as versões de .NET Framework aplicáveis.
TaskCanceledException sem nenhuma exceção interna é gerada em todas as versões aplicáveis do .NET Core.
TaskCanceledException que aninha um TimeoutException é lançado no .NET 5 e em versões posteriores.

Aplica-se a

PutAsync(String, HttpContent, CancellationToken)

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Envie uma solicitação 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);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (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 ao qual a solicitação é enviada.

content: HttpContent

O conteúdo da solicitação HTTP enviada ao servidor.

cancellationToken: CancellationToken

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

Retornos

Task<HttpResponseMessage>

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

Exceções

InvalidOperationException

O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.

HttpRequestException

A solicitação falhou devido a um problema subjacente, como conectividade de rede, falha de DNS, validação de certificado do servidor ou tempo limite.

TaskCanceledException

Somente .NET Core e .NET 5 e posterior: a solicitação falhou devido ao tempo limite.

UriFormatException

O URI de solicitação fornecido não é um URI relativo ou absoluto válido.

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

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

Observação

No caso de tempo limite, exceções diferentes são geradas em diferentes implementações do .NET.

HttpRequestExceptioné lançado em todas as versões de .NET Framework aplicáveis.
TaskCanceledException sem nenhuma exceção interna é gerada em todas as versões aplicáveis do .NET Core.
TaskCanceledException que aninha um TimeoutException é lançado no .NET 5 e em versões posteriores.

Aplica-se a

PutAsync(Uri, HttpContent, CancellationToken)

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Envie uma solicitação 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);

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 ao qual a solicitação é enviada.

content: HttpContent

O conteúdo da solicitação HTTP enviada ao servidor.

cancellationToken: CancellationToken

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

Retornos

Task<HttpResponseMessage>

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

Exceções

InvalidOperationException

O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.

HttpRequestException

A solicitação falhou devido a um problema subjacente, como conectividade de rede, falha de DNS, validação de certificado do servidor ou tempo limite.

TaskCanceledException

Somente .NET Core e .NET 5 e posterior: a solicitação falhou devido ao tempo limite.

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

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

Observação

No caso de tempo limite, exceções diferentes são geradas em diferentes implementações do .NET.

HttpRequestExceptioné lançado em todas as versões de .NET Framework aplicáveis.
TaskCanceledException sem nenhuma exceção interna é gerada em todas as versões aplicáveis do .NET Core.
TaskCanceledException que aninha um TimeoutException é lançado no .NET 5 e em versões posteriores.

Aplica-se a

Compartilhar via

HttpClient.PutAsync Método

Definição

Sobrecargas

Comentários

PutAsync(String, HttpContent)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

PutAsync(Uri, HttpContent)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

PutAsync(String, HttpContent, CancellationToken)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

PutAsync(Uri, HttpContent, CancellationToken)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

Recursos adicionais