WebClient.CancelAsync Método

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.WebClient.dll

Source:

WebClient.cs

Cancela una operación asincrónica pendiente.

public:
 void CancelAsync();

public void CancelAsync ();

member this.CancelAsync : unit -> unit

Public Sub CancelAsync ()

Comentarios

Cautela

WebRequest, HttpWebRequest, ServicePointy WebClient están obsoletos y no debe usarlos para el nuevo desarrollo. Use HttpClient en su lugar.

Si una operación está pendiente, este método llama a Abort en el WebRequestsubyacente.

Nota

A partir de .NET Core 2.0, CancelAsync no cancela la solicitud inmediatamente si la respuesta ha empezado a capturarse. Para obtener un comportamiento óptimo de cancelación, use la clase HttpClient en lugar de WebClient.

Cuando se llama a CancelAsync, la aplicación sigue recibiendo el evento de finalización asociado a la operación. Por ejemplo, al llamar a CancelAsync para cancelar una operación de DownloadStringAsync, si ha especificado un controlador de eventos para el evento DownloadStringCompleted, el controlador de eventos recibe una notificación de que la operación ha finalizado. Para saber si la operación se completó correctamente, compruebe la propiedad Cancelled en la clase base de DownloadDataCompletedEventArgs en el objeto de datos de eventos pasado al controlador de eventos.

Si no hay ninguna operación asincrónica en curso, este método no hace nada.