HttpClient.PutAsync Metoda

Definicja

Przestrzeń nazw:

System.Net.Http

Zestaw:

System.Net.Http.dll

Wyślij żądanie UMIEŚĆ do określonego identyfikatora Uri jako operację asynchroniczną.

Przeciążenia

PutAsync(String, HttpContent)	Wyślij żądanie UMIEŚĆ do określonego identyfikatora Uri jako operację asynchroniczną.
PutAsync(Uri, HttpContent)	Wyślij żądanie UMIEŚĆ do określonego identyfikatora Uri jako operację asynchroniczną.
PutAsync(String, HttpContent, CancellationToken)	Wyślij żądanie PUT z tokenem anulowania jako operację asynchroniczną.
PutAsync(Uri, HttpContent, CancellationToken)	Wyślij żądanie PUT z tokenem anulowania jako operację asynchroniczną.

Uwagi

Ta operacja nie będzie blokować.

PutAsync(String, HttpContent)

Źródło:

HttpClient.cs

Wyślij żądanie UMIEŚĆ do określonego identyfikatora Uri jako operację asynchroniczną.

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)

Parametry

requestUri

String

Wysłano identyfikator Uri żądania.

content

HttpContent

Zawartość żądania HTTP wysyłana do serwera.

Zwraca

Task<HttpResponseMessage>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

InvalidOperationException

Musi requestUri być bezwzględnym identyfikatorem URI lub BaseAddress musi być ustawiony.

HttpRequestException

Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, awaria DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.

TaskCanceledException

Tylko programy .NET Core i .NET 5 i nowsze: żądanie nie powiodło się z powodu przekroczenia limitu czasu.

UriFormatException

Podany identyfikator URI żądania jest nieprawidłowy względny lub bezwzględny identyfikator URI.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po odczytaniu całej odpowiedzi (w tym zawartości).

Uwaga

W przypadku przekroczenia limitu czasu różne wyjątki są zgłaszane w różnych implementacjach platformy .NET.

• HttpRequestExceptionjest zgłaszany we wszystkich odpowiednich wersjach .NET Framework.
• TaskCanceledException bez żadnego wyjątku wewnętrznego jest zgłaszany dla wszystkich odpowiednich wersji platformy .NET Core.
• TaskCanceledException program zagnieżdża element TimeoutException zgłaszany na platformie .NET 5 i nowszych wersjach.

PutAsync(Uri, HttpContent)

Źródło:

HttpClient.cs

Wyślij żądanie UMIEŚĆ do określonego identyfikatora Uri jako operację asynchroniczną.

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)

Parametry

requestUri

Uri

Wysłano identyfikator Uri żądania.

content

HttpContent

Zawartość żądania HTTP wysyłana do serwera.

Zwraca

Task<HttpResponseMessage>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

InvalidOperationException

Musi requestUri być bezwzględnym identyfikatorem URI lub BaseAddress musi być ustawiony.

HttpRequestException

Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, awaria DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.

TaskCanceledException

Tylko programy .NET Core i .NET 5 i nowsze: żądanie nie powiodło się z powodu przekroczenia limitu czasu.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po odczytaniu całej odpowiedzi (w tym zawartości).

Uwaga

W przypadku przekroczenia limitu czasu różne wyjątki są zgłaszane w różnych implementacjach platformy .NET.

• HttpRequestExceptionjest zgłaszany we wszystkich odpowiednich wersjach .NET Framework.
• TaskCanceledException bez żadnego wyjątku wewnętrznego jest zgłaszany dla wszystkich odpowiednich wersji platformy .NET Core.
• TaskCanceledException program zagnieżdża element TimeoutException zgłaszany na platformie .NET 5 i nowszych wersjach.

PutAsync(String, HttpContent, CancellationToken)

Źródło:

HttpClient.cs

Wyślij żądanie PUT z tokenem anulowania jako operację asynchroniczną.

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)

Parametry

requestUri

String

Wysłano identyfikator Uri żądania.

content

HttpContent

Zawartość żądania HTTP wysyłana do serwera.

cancellationToken

CancellationToken

Token odwołania, używany przez inne obiekty lub wątki do otrzymania powiadomienia o anulowaniu.

Zwraca

Task<HttpResponseMessage>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

InvalidOperationException

Musi requestUri być bezwzględnym identyfikatorem URI lub BaseAddress musi być ustawiony.

HttpRequestException

Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, awaria DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.

TaskCanceledException

Tylko programy .NET Core i .NET 5 i nowsze: żądanie nie powiodło się z powodu przekroczenia limitu czasu.

UriFormatException

Podany identyfikator URI żądania jest nieprawidłowy względny lub bezwzględny identyfikator URI.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po odczytaniu całej odpowiedzi (w tym zawartości).

Uwaga

W przypadku przekroczenia limitu czasu różne wyjątki są zgłaszane w różnych implementacjach platformy .NET.

• HttpRequestExceptionjest zgłaszany we wszystkich odpowiednich wersjach .NET Framework.
• TaskCanceledException bez żadnego wyjątku wewnętrznego jest zgłaszany dla wszystkich odpowiednich wersji platformy .NET Core.
• TaskCanceledException program zagnieżdża element TimeoutException zgłaszany na platformie .NET 5 i nowszych wersjach.

PutAsync(Uri, HttpContent, CancellationToken)

Źródło:

HttpClient.cs

Wyślij żądanie PUT z tokenem anulowania jako operację asynchroniczną.

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)

Parametry

requestUri

Uri

Wysłano identyfikator Uri żądania.

content

HttpContent

Zawartość żądania HTTP wysyłana do serwera.

cancellationToken

CancellationToken

Token odwołania, używany przez inne obiekty lub wątki do otrzymania powiadomienia o anulowaniu.

Zwraca

Task<HttpResponseMessage>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

InvalidOperationException

Musi requestUri być bezwzględnym identyfikatorem URI lub BaseAddress musi być ustawiony.

HttpRequestException

Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, awaria DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.

TaskCanceledException

Tylko programy .NET Core i .NET 5 i nowsze: żądanie nie powiodło się z powodu przekroczenia limitu czasu.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po odczytaniu całej odpowiedzi (w tym zawartości).

Uwaga

W przypadku przekroczenia limitu czasu różne wyjątki są zgłaszane w różnych implementacjach platformy .NET.

• HttpRequestExceptionjest zgłaszany we wszystkich odpowiednich wersjach .NET Framework.
• TaskCanceledException bez żadnego wyjątku wewnętrznego jest zgłaszany dla wszystkich odpowiednich wersji platformy .NET Core.
• TaskCanceledException program zagnieżdża element TimeoutException zgłaszany na platformie .NET 5 i nowszych wersjach.