HttpClient.GetStringAsync Metoda

Definicja

Przestrzeń nazw:

System.Net.Http

Zestaw:

System.Net.Http.dll

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

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

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

Task<String>

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, weryfikacja certyfikatu serwera (lub przekroczenie limitu czasu tylko dla .NET Framework).

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 treści odpowiedzi.

Uwaga

W przypadku przekroczenia limitu czasu:

• .NET Framework zgłasza błąd HttpRequestException.
• Platforma .NET Core zgłasza wyjątek TaskCanceledException wewnętrzny bez wyjątku wewnętrznego.
• Program .NET 5 i nowsze wersje zgłaszają element TaskCanceledException , który zagnieżdża element TimeoutException.

GetStringAsync(Uri)

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

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

Task<String>

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, weryfikacja certyfikatu serwera (lub przekroczenie limitu czasu tylko dla .NET Framework).

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 treści odpowiedzi.

Uwaga

W przypadku przekroczenia limitu czasu:

• .NET Framework zgłasza błąd HttpRequestException.
• Platforma .NET Core zgłasza wyjątek TaskCanceledException wewnętrzny bez wyjątku wewnętrznego.
• Program .NET 5 i nowsze wersje zgłaszają element TaskCanceledException , który zagnieżdża element TimeoutException.

GetStringAsync(String, CancellationToken)

Ź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 w celu anulowania operacji.

Zwraca

Task<String>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

Wartość requestUri to null.

HttpRequestException

Żą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).

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 treści odpowiedzi.

Uwaga

W przypadku przekroczenia limitu czasu:

• .NET Framework zgłasza błąd HttpRequestException.
• Platforma .NET Core zgłasza wyjątek TaskCanceledException wewnętrzny bez wyjątku wewnętrznego.
• Program .NET 5 i nowsze wersje zgłaszają element TaskCanceledException , który zagnieżdża element TimeoutException.

GetStringAsync(Uri, CancellationToken)

Ź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 w celu anulowania operacji.

Zwraca

Task<String>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

Wartość requestUri to null.

HttpRequestException

Żą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).

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 treści odpowiedzi.

Uwaga

W przypadku przekroczenia limitu czasu:

• .NET Framework zgłasza błąd HttpRequestException.
• Platforma .NET Core zgłasza wyjątek TaskCanceledException wewnętrzny bez wyjątku wewnętrznego.
• Program .NET 5 i nowsze wersje zgłaszają element TaskCanceledException , który zagnieżdża element TimeoutException.