WebClient.CancelAsync 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.
Anuluje oczekującą operację asynchroniczną.
public:
void CancelAsync();public void CancelAsync ();member this.CancelAsync : unit -> unitPublic Sub CancelAsync ()Uwagi
Ostrożność
WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.
Jeśli operacja oczekuje, ta metoda wywołuje Abort w bazowym WebRequest.
Nuta
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 klasy HttpClient zamiast WebClient.
Po wywołaniu CancelAsyncaplikacja nadal odbiera zdarzenie ukończenia skojarzone z operacją. Na przykład po wywołaniu CancelAsync w celu anulowania operacji DownloadStringAsync, jeśli określono procedurę obsługi zdarzeń dla zdarzenia DownloadStringCompleted, program obsługi zdarzeń otrzymuje powiadomienie o zakończeniu operacji. Aby dowiedzieć się, czy operacja została ukończona pomyślnie, sprawdź właściwość Cancelled w klasie bazowej DownloadDataCompletedEventArgs w obiekcie danych zdarzenia przekazanym do procedury obsługi zdarzeń.
Jeśli żadna operacja asynchroniczna nie jest w toku, ta metoda nic nie robi.
