WebClient.CancelAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Cancela una operación asincrónica pendiente.
public:
void CancelAsync();public void CancelAsync ();member this.CancelAsync : unit -> unitPublic 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.
