Udostępnij za pośrednictwem


HttpClient.GetStringAsync Metoda

Definicja

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:

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:

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:

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:

Dotyczy