Udostępnij za pośrednictwem


HttpClient.GetAsync Metoda

Definicja

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
Źródło:
HttpClient.cs
Ź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);
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

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

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

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

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

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.

Dotyczy

GetAsync(Uri)

Źródło:
HttpClient.cs
Źródło:
HttpClient.cs
Ź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);
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

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

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

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

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.

Dotyczy

GetAsync(String, HttpCompletionOption)

Źródło:
HttpClient.cs
Źródło:
HttpClient.cs
Ź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);
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

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

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

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

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

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.

Dotyczy

GetAsync(String, CancellationToken)

Źródło:
HttpClient.cs
Źródło:
HttpClient.cs
Ź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);
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

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

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

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

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

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

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.

Dotyczy

GetAsync(Uri, HttpCompletionOption)

Źródło:
HttpClient.cs
Źródło:
HttpClient.cs
Ź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);
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

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

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

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

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.

Dotyczy

GetAsync(Uri, CancellationToken)

Źródło:
HttpClient.cs
Źródło:
HttpClient.cs
Ź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);
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

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

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

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

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

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.

Dotyczy

GetAsync(String, HttpCompletionOption, CancellationToken)

Źródło:
HttpClient.cs
Źródło:
HttpClient.cs
Ź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);
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

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

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

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

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

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

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> 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.

Dotyczy

GetAsync(Uri, HttpCompletionOption, CancellationToken)

Źródło:
HttpClient.cs
Źródło:
HttpClient.cs
Ź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);
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

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

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

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

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

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> 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.

Dotyczy