HttpClient.GetStringAsync Metoda
Definicja
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 POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako ciąg w operacji asynchronicznej.
Przeciążenia
| GetStringAsync(String) |
Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako ciąg w operacji asynchronicznej. |
| GetStringAsync(Uri) |
Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako ciąg w operacji asynchronicznej. |
| GetStringAsync(String, CancellationToken) |
Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako ciąg w operacji asynchronicznej. |
| GetStringAsync(Uri, CancellationToken) |
Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako ciąg w operacji asynchronicznej. |
Uwagi
Ta operacja nie będzie blokować.
GetStringAsync(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 i zwróć treść odpowiedzi jako ciąg w operacji asynchronicznej.
public:
System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(System::String ^ requestUri);public System.Threading.Tasks.Task<string> GetStringAsync (string requestUri);public System.Threading.Tasks.Task<string> GetStringAsync (string? requestUri);member this.GetStringAsync : string -> System.Threading.Tasks.Task<string>Public Function GetStringAsync (requestUri As String) As Task(Of String)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, niepowodzenie DNS, weryfikacja certyfikatu serwera (lub przekroczenie limitu czasu tylko dla .NET Framework).
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 treści odpowiedzi.
Uwaga
W przypadku przekroczenia limitu czasu:
- .NET Framework zgłasza błąd HttpRequestException.
- Program .NET Core zgłasza TaskCanceledException wyjątek bez wyjątku wewnętrznego.
- Program .NET 5 i nowsze wersje zgłaszają zagnieżdżanie TaskCanceledException .TimeoutException
Dotyczy
GetStringAsync(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 i zwróć treść odpowiedzi jako ciąg w operacji asynchronicznej.
public:
System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(Uri ^ requestUri);public System.Threading.Tasks.Task<string> GetStringAsync (Uri requestUri);public System.Threading.Tasks.Task<string> GetStringAsync (Uri? requestUri);member this.GetStringAsync : Uri -> System.Threading.Tasks.Task<string>Public Function GetStringAsync (requestUri As Uri) As Task(Of String)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, niepowodzenie DNS, weryfikacja certyfikatu serwera (lub przekroczenie limitu czasu tylko dla .NET Framework).
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 treści odpowiedzi.
Uwaga
W przypadku przekroczenia limitu czasu:
- .NET Framework zgłasza błąd HttpRequestException.
- Program .NET Core zgłasza TaskCanceledException wyjątek bez wyjątku wewnętrznego.
- Program .NET 5 i nowsze wersje zgłaszają zagnieżdżanie TaskCanceledException .TimeoutException
Dotyczy
GetStringAsync(String, CancellationToken)
- Źródło:
- HttpClient.cs
- Źródło:
- HttpClient.cs
- Źródło:
- HttpClient.cs
Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako ciąg w operacji asynchronicznej.
public:
System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<string> GetStringAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);member this.GetStringAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>Public Function GetStringAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of String)Parametry
- requestUri
- String
Wysłano identyfikator Uri żądania.
- cancellationToken
- CancellationToken
Token anulowania, aby anulować operację.
Zwraca
Obiekt zadania reprezentujący operację asynchroniczną.
Wyjątki
Element requestUri to null.
Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, niepowodzenie DNS, weryfikacja certyfikatu serwera (lub przekroczenie limitu czasu tylko dla .NET Framework).
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 treści odpowiedzi.
Uwaga
W przypadku przekroczenia limitu czasu:
- .NET Framework zgłasza błąd HttpRequestException.
- Program .NET Core zgłasza TaskCanceledException wyjątek bez wyjątku wewnętrznego.
- Program .NET 5 i nowsze wersje zgłaszają zagnieżdżanie TaskCanceledException .TimeoutException
Dotyczy
GetStringAsync(Uri, CancellationToken)
- Źródło:
- HttpClient.cs
- Źródło:
- HttpClient.cs
- Źródło:
- HttpClient.cs
Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako ciąg w operacji asynchronicznej.
public:
System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<string> GetStringAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);member this.GetStringAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>Public Function GetStringAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of String)Parametry
- requestUri
- Uri
Wysłano identyfikator Uri żądania.
- cancellationToken
- CancellationToken
Token anulowania, aby anulować operację.
Zwraca
Obiekt zadania reprezentujący operację asynchroniczną.
Wyjątki
Element requestUri to null.
Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, niepowodzenie DNS, weryfikacja certyfikatu serwera (lub przekroczenie limitu czasu tylko dla .NET Framework).
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 treści odpowiedzi.
Uwaga
W przypadku przekroczenia limitu czasu:
- .NET Framework zgłasza błąd HttpRequestException.
- Program .NET Core zgłasza TaskCanceledException wyjątek bez wyjątku wewnętrznego.
- Program .NET 5 i nowsze wersje zgłaszają zagnieżdżanie TaskCanceledException .TimeoutException
