HttpClient.GetAsync Metoda

Definicja

Przestrzeń nazw:

System.Net.Http

Zestaw:

System.Net.Http.dll

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

Przeciążenia

GetAsync(String)	Wyślij żądanie POBIERZ do określonego identyfikatora Uri jako operację asynchroniczną.
GetAsync(Uri)	Wyślij żądanie POBIERZ do określonego identyfikatora Uri jako operację asynchroniczną.
GetAsync(String, HttpCompletionOption)	Wyślij żądanie GET do określonego identyfikatora URI z opcją uzupełniania HTTP jako operację asynchroniczną.
GetAsync(String, CancellationToken)	Wyślij żądanie GET do określonego identyfikatora URI z tokenem anulowania jako operacją asynchroniczną.
GetAsync(Uri, HttpCompletionOption)	Wyślij żądanie GET do określonego identyfikatora URI z opcją uzupełniania HTTP jako operację asynchroniczną.
GetAsync(Uri, CancellationToken)	Wyślij żądanie GET do określonego identyfikatora URI z tokenem anulowania jako operacją asynchroniczną.
GetAsync(String, HttpCompletionOption, CancellationToken)	Wyślij żądanie GET do określonego identyfikatora URI z opcją uzupełniania HTTP i tokenem anulowania jako operacją asynchroniczną.
GetAsync(Uri, HttpCompletionOption, CancellationToken)	Wyślij żądanie GET do określonego identyfikatora URI z opcją uzupełniania HTTP i tokenem anulowania jako operacją asynchroniczną.

Uwagi

Operacja nie będzie blokować.

GetAsync(String)

Źródło:

HttpClient.cs

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

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string? requestUri);

member this.GetAsync : string -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As String) As Task(Of HttpResponseMessage)

Parametry

requestUri

String

Wysłano identyfikator Uri żądania.

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). Zachowanie jest takie samo, jak w przypadku ResponseContentRead jawnego określenia.

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.

GetAsync(Uri)

Źródło:

HttpClient.cs

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

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri? requestUri);

member this.GetAsync : Uri -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As Uri) As Task(Of HttpResponseMessage)

Parametry

requestUri

Uri

Wysłano identyfikator Uri żądania.

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). Zachowanie jest takie samo, jak w przypadku ResponseContentRead jawnego określenia.

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.

GetAsync(String, HttpCompletionOption)

Źródło:

HttpClient.cs

Wyślij żądanie GET do określonego identyfikatora URI z opcją uzupełniania HTTP jako operację asynchroniczną.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string? requestUri, System.Net.Http.HttpCompletionOption completionOption);

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

Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)

Parametry

requestUri

String

Wysłano identyfikator Uri żądania.

completionOption

HttpCompletionOption

Wartość opcji zakończenia aplikacji HTTP, która wskazuje, kiedy operację należy uznać za zakończoną.

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> na podstawie parametru completionOption po odczytaniu części lub 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.

GetAsync(String, CancellationToken)

Źródło:

HttpClient.cs

Wyślij żądanie GET do określonego identyfikatora URI z tokenem anulowania jako operacją asynchroniczną.

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

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);

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

Public Function GetAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parametry

requestUri

String

Wysłano identyfikator Uri żądania.

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). Zachowanie jest takie samo, jak w przypadku ResponseContentRead jawnego określenia.

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.

GetAsync(Uri, HttpCompletionOption)

Źródło:

HttpClient.cs

Wyślij żądanie GET do określonego identyfikatora URI z opcją uzupełniania HTTP jako operację asynchroniczną.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri? requestUri, System.Net.Http.HttpCompletionOption completionOption);

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

Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)

Parametry

requestUri

Uri

Wysłano identyfikator Uri żądania.

completionOption

HttpCompletionOption

Wartość opcji zakończenia aplikacji HTTP, która wskazuje, kiedy operację należy uznać za zakończoną.

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> na podstawie parametru completionOption po odczytaniu części lub 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.

GetAsync(Uri, CancellationToken)

Źródło:

HttpClient.cs

Wyślij żądanie GET do określonego identyfikatora URI z tokenem anulowania jako operacją asynchroniczną.

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

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);

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

Public Function GetAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parametry

requestUri

Uri

Wysłano identyfikator Uri żądania.

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). Zachowanie jest takie samo, jak w przypadku ResponseContentRead jawnego określenia.

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.

GetAsync(String, HttpCompletionOption, CancellationToken)

Źródło:

HttpClient.cs

Wyślij żądanie GET do określonego identyfikatora URI z opcją uzupełniania HTTP i tokenem anulowania jako operacją asynchroniczną.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string? requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);

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

Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parametry

requestUri

String

Wysłano identyfikator Uri żądania.

completionOption

HttpCompletionOption

Wartość opcji zakończenia aplikacji HTTP, która wskazuje, kiedy operację należy uznać za zakończoną.

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> na podstawie parametru completionOption po odczytaniu części lub 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.

GetAsync(Uri, HttpCompletionOption, CancellationToken)

Źródło:

HttpClient.cs

Wyślij żądanie GET do określonego identyfikatora URI z opcją uzupełniania HTTP i tokenem anulowania jako operacją asynchroniczną.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri? requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);

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

Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Parametry

requestUri

Uri

Wysłano identyfikator Uri żądania.

completionOption

HttpCompletionOption

Wartość opcji zakończenia aplikacji HTTP, która wskazuje, kiedy operację należy uznać za zakończoną.

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> na podstawie parametru completionOption po odczytaniu części lub 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.