WebClient.CancelAsync Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Net
Zestaw:
System.Net.WebClient.dll
Zestaw:
System.dll
Zestaw:
netstandard.dll
Źródło:
WebClient.cs
Źródło:
WebClient.cs
Źródło:
WebClient.cs

Anuluje oczekującą operację asynchroniczną.

public:
 void CancelAsync();
public void CancelAsync ();
member this.CancelAsync : unit -> unit
Public Sub CancelAsync ()

Uwagi

Jeśli operacja jest oczekująca, ta metoda wywołuje Abort podstawową WebRequestmetodę .

Uwaga

Począwszy od platformy .NET Core 2.0, CancelAsync nie anuluje żądania natychmiast, jeśli odpowiedź zaczęła pobierać. Aby uzyskać optymalne zachowanie anulowania, użyj HttpClient klasy zamiast WebClient.

Po wywołaniu wywołania CancelAsyncaplikacja nadal odbiera zdarzenie ukończenia skojarzone z operacją. Na przykład podczas wywoływania w CancelAsync celu anulowania operacji, jeśli określono procedurę DownloadStringAsync obsługi zdarzeń dla zdarzenia, program obsługi zdarzeń odbiera powiadomienie o zakończeniu DownloadStringCompleted operacji. Aby dowiedzieć się, czy operacja zakończyła się pomyślnie, sprawdź Cancelled właściwość klasy bazowej DownloadDataCompletedEventArgs obiektu danych zdarzenia przekazanego do programu obsługi zdarzeń.

Jeśli żadna operacja asynchroniczna nie jest w toku, ta metoda nic nie robi.

Dotyczy