WebClient.DownloadStringTaskAsync 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.
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
- Źródło:
- WebClient.cs
- Ź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);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (string address);
member this.DownloadStringTaskAsync : string -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
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
Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca tablicę zawierającą Byte pobrany zasób.
- Atrybuty
Wyjątki
Parametr address
ma wartość null
.
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 wywołującego wątku podczas pobierania zasobu.
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 address
elementu .
Ta metoda używa polecenia RETR, aby pobrać zasób 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 programie .NET Framework.
Dotyczy
DownloadStringTaskAsync(Uri)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Ź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);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (Uri address);
member this.DownloadStringTaskAsync : Uri -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
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
Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca tablicę zawierającą Byte pobrany zasób.
- Atrybuty
Wyjątki
Parametr address
ma wartość null
.
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 wywołującego wątku podczas pobierania zasobu.
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 address
elementu .
Ta metoda używa polecenia RETR, aby pobrać zasób 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 programie .NET Framework.
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla