HttpClient.PostAsync Metoda

Definicja

Przestrzeń nazw:

System.Net.Http

Zestaw:

System.Net.Http.dll

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

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);

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.

PostAsync(Uri, HttpContent, CancellationToken)

Ź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);

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.

PostAsync(String, HttpContent)

Ź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);

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.

PostAsync(Uri, HttpContent)

Ź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);

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.