WebClient.CancelAsync Método

  • Referencia

Definición

Espacio de nombres:
System.Net
Ensamblado:
System.Net.WebClient.dll
Ensamblado:
System.dll
Ensamblado:
netstandard.dll
Source:
WebClient.cs
Source:
WebClient.cs
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

Si hay una operación pendiente, este método llama a Abort en el subyacente WebRequest.

Nota

A partir de .NET Core 2.0, CancelAsync no cancela la solicitud inmediatamente si la respuesta se ha iniciado para capturar. Para un comportamiento óptimo de cancelación, use la HttpClient clase 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 CancelAsync a para cancelar una DownloadStringAsync operación, si ha especificado un controlador de eventos para el evento, el DownloadStringCompleted 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 Cancelled propiedad en la clase base de DownloadDataCompletedEventArgs en el objeto de datos del evento pasado al controlador de eventos.

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

Se aplica a