WebClient.DownloadDataTaskAsync 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 tablicę Byte z identyfikatora URI określonego jako operację asynchroniczną przy użyciu obiektu zadania. Te metody nie blokują wątku wywołującego.
Przeciążenia
DownloadDataTaskAsync(String) |
Pobiera zasób jako tablicę Byte z identyfikatora URI określonego jako operację asynchroniczną przy użyciu obiektu zadania. |
DownloadDataTaskAsync(Uri) |
Pobiera zasób jako tablicę Byte z identyfikatora URI określonego jako operację asynchroniczną przy użyciu obiektu zadania. |
DownloadDataTaskAsync(String)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
Pobiera zasób jako tablicę Byte z identyfikatora URI określonego jako operację asynchroniczną przy użyciu obiektu zadania.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(System::String ^ address);
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (string address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (string address);
member this.DownloadDataTaskAsync : string -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadDataTaskAsync : string -> System.Threading.Tasks.Task<byte[]>
Public Function DownloadDataTaskAsync (address As String) As Task(Of Byte())
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
to 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.
Ta metoda pobiera określony zasób przy użyciu domyślnej metody protokołu skojarzonego ze schematem identyfikatora URI określonego w parametrze address
. Dane są pobierane asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków.
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 address
elementu .
Ta metoda używa polecenia RETR do pobrania zasobu 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.
Poniższy przykład kodu żąda danych z serwera i wyświetla zwrócone dane. Przyjęto założenie, że remoteUri
zawiera prawidłowy identyfikator URI dla żądanych danych.
Dotyczy
DownloadDataTaskAsync(Uri)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
Pobiera zasób jako tablicę Byte z identyfikatora URI określonego jako operację asynchroniczną przy użyciu obiektu zadania.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(Uri ^ address);
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (Uri address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (Uri address);
member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>
Public Function DownloadDataTaskAsync (address As Uri) As Task(Of Byte())
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
to 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.
Ta metoda pobiera określony zasób przy użyciu domyślnej metody protokołu skojarzonego ze schematem identyfikatora URI określonego w parametrze address
. Dane są pobierane asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków.
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 address
elementu .
Ta metoda używa polecenia RETR do pobrania zasobu 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.
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