WebClient.DownloadDataAsync Metod

public:
 void DownloadDataAsync(Uri ^ address);

public void DownloadDataAsync(Uri address);

member this.DownloadDataAsync : Uri -> unit

Public Sub DownloadDataAsync (address As Uri)

Parametrar

Undantag

Kommentarer

Den här metoden hämtar den angivna resursen med standardmetoden för protokollet som är associerat med det URI-schema som anges i address. Data laddas ned asynkront med hjälp av trådresurser som automatiskt allokeras från trådpoolen.

Den här metoden blockerar inte den anropande tråden när resursen laddas ned. Om du vill ladda ned en resurs och blockera i väntan på serverns svar använder du någon av DownloadData metoderna. När nedladdningen är klar utlöses DownloadDataCompleted händelsen. Programmet måste hantera den här händelsen för att få ett meddelande. De nedladdade data är tillgängliga i egenskapen Result .

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

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.

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 lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av DownloadData(Uri).

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

public void DownloadDataAsync(Uri address, object userToken);

member this.DownloadDataAsync : Uri * obj -> unit

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

Parametrar

Undantag

Kommentarer

Den här metoden hämtar den angivna resursen med standardmetoden för protokollet som är associerat med det URI-schema som anges i address. Data laddas ned asynkront med hjälp av trådresurser som automatiskt allokeras från trådpoolen.

Den här metoden blockerar inte den anropande tråden när resursen laddas ned. Om du vill ladda ned en resurs och blockera i väntan på serverns svar använder du någon av DownloadData metoderna. När nedladdningen är klar utlöses DownloadDataCompleted händelsen. Programmet måste hantera den här händelsen för att få ett meddelande. De nedladdade data är tillgängliga i egenskapen Result .

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

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.

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 .