WebClient.DownloadStringTaskAsync Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Pobiera zasób jako element String z identyfikatora URI określonego jako operację asynchroniczną przy użyciu obiektu zadania. Te metody nie blokują wątku wywołującego.

Przeciążenia

DownloadStringTaskAsync(String)	Pobiera zasób jako element String z identyfikatora URI określonego jako operację asynchroniczną przy użyciu obiektu zadania.
DownloadStringTaskAsync(Uri)	Pobiera zasób jako element String z identyfikatora URI określonego jako operację asynchroniczną przy użyciu obiektu zadania.

DownloadStringTaskAsync(String)

Źródło:

WebClient.cs

Pobiera zasób jako element String z identyfikatora URI określonego jako operację asynchroniczną przy użyciu obiektu zadania.

public:
 System::Threading::Tasks::Task<System::String ^> ^ DownloadStringTaskAsync(System::String ^ address);

public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (string address);

member this.DownloadStringTaskAsync : string -> System.Threading.Tasks.Task<string>

Public Function DownloadStringTaskAsync (address As String) As Task(Of String)

Parametry

address

String

Identyfikator URI zasobu do pobrania.

Zwraca

Task<String>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca tablicę zawierającą Byte pobrany zasób.

Wyjątki

ArgumentNullException

Parametr address to null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.

-lub-

Wystąpił błąd podczas pobierania zasobu.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po pobraniu zasobu danych. Zasób jest pobierany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków.

Po pobraniu zasobu ta metoda używa kodowania określonego Encoding we właściwości, aby przekonwertować zasób na .String Ta metoda nie blokuje wątku wywołującego podczas pobierania zasobu.

W .NET Framework i .NET Core 1.0 można anulować operacje asynchroniczne, które nie zostały ukończone, wywołując metodę CancelAsync .

BaseAddress Jeśli właściwość nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, musi być względnym identyfikatorem URI połączonym address z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych. QueryString Jeśli właściwość nie jest pustym ciągiem, jest dołączana do addresselementu .

Ta metoda używa polecenia RETR do pobrania zasobu FTP. W przypadku zasobu HTTP jest używana metoda GET.

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

DownloadStringTaskAsync(Uri)

Źródło:

WebClient.cs

Pobiera zasób jako element String z identyfikatora URI określonego jako operację asynchroniczną przy użyciu obiektu zadania.

public:
 System::Threading::Tasks::Task<System::String ^> ^ DownloadStringTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (Uri address);

member this.DownloadStringTaskAsync : Uri -> System.Threading.Tasks.Task<string>

Public Function DownloadStringTaskAsync (address As Uri) As Task(Of String)

Parametry

address

Uri

Identyfikator URI zasobu do pobrania.

Zwraca

Task<String>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca tablicę zawierającą Byte pobrany zasób.

Wyjątki

ArgumentNullException

Parametr address to null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.

-lub-

Wystąpił błąd podczas pobierania zasobu.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po pobraniu zasobu danych. Zasób jest pobierany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków.

Po pobraniu zasobu ta metoda używa kodowania określonego Encoding we właściwości, aby przekonwertować zasób na .String Ta metoda nie blokuje wątku wywołującego podczas pobierania zasobu.

W .NET Framework i .NET Core 1.0 można anulować operacje asynchroniczne, które nie zostały ukończone, wywołując metodę CancelAsync .

BaseAddress Jeśli właściwość nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, musi być względnym identyfikatorem URI połączonym address z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych. QueryString Jeśli właściwość nie jest pustym ciągiem, jest dołączana do addresselementu .

Ta metoda używa polecenia RETR do pobrania zasobu FTP. W przypadku zasobu HTTP jest używana metoda GET.

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.