WebClient.DownloadDataTaskAsync Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Laddar ned resursen som en Byte matris från den URI som anges som en asynkron åtgärd med hjälp av ett aktivitetsobjekt. Dessa metoder blockerar inte den anropande tråden.
Överlagringar
| Name | Description |
|---|---|
| DownloadDataTaskAsync(String) |
Laddar ned resursen som en Byte matris från den URI som anges som en asynkron åtgärd med hjälp av ett aktivitetsobjekt. |
| DownloadDataTaskAsync(Uri) |
Laddar ned resursen som en Byte matris från den URI som anges som en asynkron åtgärd med hjälp av ett aktivitetsobjekt. |
DownloadDataTaskAsync(String)
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
Laddar ned resursen som en Byte matris från den URI som anges som en asynkron åtgärd med hjälp av ett aktivitetsobjekt.
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())Parametrar
- address
- String
URI:n för resursen som ska laddas ned.
Returer
Aktivitetsobjektet som representerar den asynkrona åtgärden. Egenskapen Result för aktivitetsobjektet returnerar en Byte matris som innehåller den nedladdade resursen.
- Attribut
Undantag
Parametern address är null.
Den URI som skapas genom att kombinera BaseAddress och address är ogiltig.
-eller-
Ett fel uppstod när resursen skulle laddas ned.
Kommentarer
Caution
WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.
Den här åtgärden kommer inte att blockeras. Det returnerade objektet slutförs Task<TResult> när dataresursen har laddats ned.
Den här metoden hämtar den angivna resursen med standardmetoden för protokollet som är associerat med det URI-schema som anges i parametern address . Data laddas ned asynkront med hjälp av trådresurser som automatiskt allokeras från trådpoolen.
Om egenskapen BaseAddress inte är en tom sträng ("") och address inte innehåller en absolut URI måste address den vara en relativ URI som kombineras med BaseAddress för att bilda den absoluta URI:n för de begärda data. Om egenskapen QueryString inte är en tom sträng läggs den till addressi .
Den här metoden använder RETR-kommandot för att ladda ned en FTP-resurs. För en HTTP-resurs används GET-metoden.
Note
Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.
I följande kodexempel begärs data från en server och de data som returneras visas. Det förutsätter att remoteUri innehåller en giltig URI för begärda data.
Gäller för
DownloadDataTaskAsync(Uri)
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
Laddar ned resursen som en Byte matris från den URI som anges som en asynkron åtgärd med hjälp av ett aktivitetsobjekt.
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())Parametrar
- address
- Uri
URI:n för resursen som ska laddas ned.
Returer
Aktivitetsobjektet som representerar den asynkrona åtgärden. Egenskapen Result för aktivitetsobjektet returnerar en Byte matris som innehåller den nedladdade resursen.
- Attribut
Undantag
Parametern address är null.
Den URI som skapas genom att kombinera BaseAddress och address är ogiltig.
-eller-
Ett fel uppstod när resursen skulle laddas ned.
Kommentarer
Caution
WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.
Den här åtgärden kommer inte att blockeras. Det returnerade objektet slutförs Task<TResult> när dataresursen har laddats ned.
Den här metoden hämtar den angivna resursen med standardmetoden för protokollet som är associerat med det URI-schema som anges i parametern address . Data laddas ned asynkront med hjälp av trådresurser som automatiskt allokeras från trådpoolen.
Om egenskapen BaseAddress inte är en tom sträng ("") och address inte innehåller en absolut URI måste address den vara en relativ URI som kombineras med BaseAddress för att bilda den absoluta URI:n för de begärda data. Om egenskapen QueryString inte är en tom sträng läggs den till addressi .
Den här metoden använder RETR-kommandot för att ladda ned en FTP-resurs. För en HTTP-resurs används GET-metoden.
Note
Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.
