WebClient.DownloadStringAsync Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Pobiera zasób określony jako lub StringUri. Te metody nie blokują wątku wywołującego.

Przeciążenia

DownloadStringAsync(Uri)	Pobiera zasób określony jako Uri. Ta metoda nie blokuje wątku wywołującego.
DownloadStringAsync(Uri, Object)	Pobiera określony ciąg do określonego zasobu. Ta metoda nie blokuje wątku wywołującego.

DownloadStringAsync(Uri)

Źródło:

WebClient.cs

Pobiera zasób określony jako Uri. Ta metoda nie blokuje wątku wywołującego.

public:
 void DownloadStringAsync(Uri ^ address);

public void DownloadStringAsync (Uri address);

member this.DownloadStringAsync : Uri -> unit

Public Sub DownloadStringAsync (address As Uri)

Parametry

address

Uri

Identyfikator Uri zawierający identyfikator URI do pobrania.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

WebException

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

-lub-

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

Uwagi

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 wywołującego wątku podczas pobierania zasobu. Aby pobrać zasób i zablokować podczas oczekiwania na odpowiedź serwera, użyj DownloadString metody . Po zakończeniu pobierania zostanie DownloadStringCompleted zgłoszone zdarzenie. Aplikacja musi obsługiwać to zdarzenie, aby otrzymywać powiadomienia. Pobrany ciąg jest dostępny we Result właściwości .

W programach .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 ciągiem pustym, jest dołączana do addresselementu .

Ta metoda używa polecenia RETR, aby pobrać zasób FTP. W przypadku zasobu HTTP jest używana metoda GET.

Uwaga

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 programie .NET Framework.

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez DownloadString(Uri)usługę .

DownloadStringAsync(Uri, Object)

Źródło:

WebClient.cs

Pobiera określony ciąg do określonego zasobu. Ta metoda nie blokuje wątku wywołującego.

public:
 void DownloadStringAsync(Uri ^ address, System::Object ^ userToken);

public void DownloadStringAsync (Uri address, object? userToken);

member this.DownloadStringAsync : Uri * obj -> unit

Public Sub DownloadStringAsync (address As Uri, userToken As Object)

Parametry

address

Uri

Identyfikator Uri zawierający identyfikator URI do pobrania.

userToken

Object

Obiekt zdefiniowany przez użytkownika, który jest przekazywany do metody wywoływanej po zakończeniu operacji asynchronicznej.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

WebException

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

-lub-

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

Uwagi

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 wywołującego wątku podczas pobierania zasobu. Aby pobrać zasób i zablokować podczas oczekiwania na odpowiedź serwera, użyj DownloadString metody . Po zakończeniu pobierania zostanie DownloadStringCompleted zgłoszone zdarzenie. Aplikacja musi obsługiwać to zdarzenie, aby otrzymywać powiadomienia. Pobrany ciąg jest dostępny we Result właściwości .

W programach .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 ciągiem pustym, jest dołączana do addresselementu .

Ta metoda używa polecenia RETR, aby pobrać zasób FTP. W przypadku zasobu HTTP jest używana metoda GET.

Uwaga

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 programie .NET Framework.