WebClient.DownloadStringTaskAsync Metod

Definition

Namnområde:

System.Net

Sammansättning:

System.dll

Laddar ned resursen som en String 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
DownloadStringTaskAsync(String)	Laddar ned resursen som en String från den URI som anges som en asynkron åtgärd med hjälp av ett aktivitetsobjekt.
DownloadStringTaskAsync(Uri)	Laddar ned resursen som en String från den URI som anges som en asynkron åtgärd med hjälp av ett aktivitetsobjekt.

DownloadStringTaskAsync(String)

Laddar ned resursen som en String från den URI som anges som en asynkron åtgärd med hjälp av ett aktivitetsobjekt.

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

[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> DownloadStringTaskAsync(string address);

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadStringTaskAsync : string -> System.Threading.Tasks.Task<string>

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

Parametrar

address

String

URI:n för resursen som ska laddas ned.

Returer

Task<String>

Aktivitetsobjektet som representerar den asynkrona åtgärden. Egenskapen Result för aktivitetsobjektet returnerar en Byte matris som innehåller den nedladdade resursen.

Attribut

ComVisibleAttribute

Undantag

ArgumentNullException

Parametern address är null.

WebException

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. Resursen laddas ned asynkront med hjälp av trådresurser som automatiskt allokeras från trådpoolen.

När du har laddat ned resursen använder den här metoden den kodning som anges i Encoding egenskapen för att konvertera resursen till en String. Den här metoden blockerar inte den anropande tråden när resursen laddas ned.

I .NET Framework kan du avbryta asynkrona åtgärder som inte har slutförts genom att anropa metoden CancelAsync.

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.

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.

DownloadStringTaskAsync(Uri)

Laddar ned resursen som en String från den URI som anges som en asynkron åtgärd med hjälp av ett aktivitetsobjekt.

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

[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> DownloadStringTaskAsync(Uri address);

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadStringTaskAsync : Uri -> System.Threading.Tasks.Task<string>

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

Parametrar

address

Uri

URI:n för resursen som ska laddas ned.

Returer

Task<String>

Aktivitetsobjektet som representerar den asynkrona åtgärden. Egenskapen Result för aktivitetsobjektet returnerar en Byte matris som innehåller den nedladdade resursen.

Attribut

ComVisibleAttribute

Undantag

ArgumentNullException

Parametern address är null.

WebException

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. Resursen laddas ned asynkront med hjälp av trådresurser som automatiskt allokeras från trådpoolen.

När du har laddat ned resursen använder den här metoden den kodning som anges i Encoding egenskapen för att konvertera resursen till en String. Den här metoden blockerar inte den anropande tråden när resursen laddas ned.

I .NET Framework kan du avbryta asynkrona åtgärder som inte har slutförts genom att anropa metoden CancelAsync.

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.

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.