HttpClient.PostAsync Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Net.Http

Zestaw:: System.Net.Http.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

Przeciążenia

PostAsync(String, HttpContent, CancellationToken)	Wyślij żądanie POST z tokenem anulowania jako operacją asynchroniczną.
PostAsync(Uri, HttpContent, CancellationToken)	Wyślij żądanie POST z tokenem anulowania jako operacją asynchroniczną.
PostAsync(String, HttpContent)	Wyślij żądanie WYŚLIJ do określonego identyfikatora Uri jako operację asynchroniczną.
PostAsync(Uri, HttpContent)	Wyślij żądanie WYŚLIJ do określonego identyfikatora Uri jako operację asynchroniczną.

Uwagi

Ta operacja nie będzie blokować.

PostAsync(String, HttpContent, CancellationToken)

Źródło:: HttpClient.cs

Źródło:: HttpClient.cs

Źródło:: HttpClient.cs

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

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)

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, niepowodzenie DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.

TaskCanceledException

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

UriFormatException

Podany identyfikator URI żądania nie jest prawidłowym względnym lub bezwzględnym identyfikatorem URI.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym 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 we wszystkich odpowiednich wersjach platformy .NET Core.
TaskCanceledException zagnieżdża TimeoutException element , który jest zgłaszany na platformie .NET 5 i nowszych wersjach.

Dotyczy

PostAsync(Uri, HttpContent, CancellationToken)

Źródło:: HttpClient.cs

Źródło:: HttpClient.cs

Źródło:: HttpClient.cs

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

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)

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, niepowodzenie DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.

TaskCanceledException

Tylko platformy .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 zwracanym 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 we wszystkich odpowiednich wersjach platformy .NET Core.
TaskCanceledException zagnieżdża TimeoutException element , który jest zgłaszany na platformie .NET 5 i nowszych wersjach.

Dotyczy

PostAsync(String, HttpContent)

Źródło:: HttpClient.cs

Źródło:: HttpClient.cs

Źródło:: HttpClient.cs

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

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)

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, niepowodzenie DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.

TaskCanceledException

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

UriFormatException

Podany identyfikator URI żądania nie jest prawidłowym względnym lub bezwzględnym identyfikatorem 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 we wszystkich odpowiednich wersjach platformy .NET Core.
TaskCanceledException zagnieżdża TimeoutException element , który jest zgłaszany na platformie .NET 5 i nowszych wersjach.

Dotyczy

PostAsync(Uri, HttpContent)

Źródło:: HttpClient.cs

Źródło:: HttpClient.cs

Źródło:: HttpClient.cs

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

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)

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, niepowodzenie DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.

TaskCanceledException

Tylko platformy .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 we wszystkich odpowiednich wersjach platformy .NET Core.
TaskCanceledException zagnieżdża TimeoutException element , który jest zgłaszany na platformie .NET 5 i nowszych wersjach.

Dotyczy

Udostępnij za pośrednictwem

HttpClient.PostAsync Metoda

Definicja

Przeciążenia

Uwagi

PostAsync(String, HttpContent, CancellationToken)

Parametry

Zwraca

Wyjątki

Uwagi

Dotyczy

PostAsync(Uri, HttpContent, CancellationToken)

Parametry

Zwraca

Wyjątki

Uwagi

Dotyczy

PostAsync(String, HttpContent)

Parametry

Zwraca

Wyjątki

Uwagi

Dotyczy

PostAsync(Uri, HttpContent)

Parametry

Zwraca

Wyjątki

Uwagi

Dotyczy

Dodatkowe zasoby