PictureBox.CancelAsync Método

Definición

Cancela una carga de la imagen asincrónica.Cancels an asynchronous image load.

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

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método CancelAsync.The following code example demonstrates how to use the CancelAsync method. Para ejecutar este ejemplo, pegue el código siguiente en un formulario de Windows Forms que contenga un PictureBox denominado pictureBox1 y dos controles de Button denominados startLoadButton y cancelLoadButton.To run this example, paste the following code into a Windows Form that contains a PictureBox named pictureBox1 and two Button controls named startLoadButton and cancelLoadButton. Asegúrese de que el evento Click de los botones está asociado a su método de control de eventos en este ejemplo.Make sure that the Click event for the buttons is associated with their event-handling method in this example. Debe cambiar la ruta de acceso del archivo de imagen a una ruta de acceso válida en el sistema.You must change the image file path to a path that is valid on your system.

private void startButton_Click(object sender, EventArgs e)
{
    // Ensure WaitOnLoad is false.
    pictureBox1.WaitOnLoad = false;

    // Load the image asynchronously.
    pictureBox1.LoadAsync(@"http://localhost/print.gif");
}
Private Sub startLoadButton_Click(ByVal sender As Object, _
    ByVal e As EventArgs) Handles startLoadButton.Click

    ' Ensure WaitOnLoad is false.
    pictureBox1.WaitOnLoad = False

    ' Load the image asynchronously.
    pictureBox1.LoadAsync("http://localhost/print.gif")

End Sub

private void cancelButton_Click(object sender, EventArgs e)
{
    pictureBox1.CancelAsync();
}
Private Sub cancelLoadButton_Click(ByVal sender As Object, _
    ByVal e As EventArgs) Handles cancelLoadButton.Click
    pictureBox1.CancelAsync()

End Sub

Comentarios

Una imagen de PictureBox se carga de forma asincrónica cuando se false la propiedad WaitOnLoad y se usa el método LoadAsync para cargar la imagen.A PictureBox image is loaded asynchronously when the WaitOnLoad property is false and the LoadAsync method is used to load the image. Si se cancela una carga con el CancelAsync se registra la cancelación del método generando el evento LoadCompleted con la propiedad Cancelled de la AsyncCompletedEventArgs establecida en true.If a load is canceled with the CancelAsync method cancellation is reported by raising the LoadCompleted event with the Cancelled property of the AsyncCompletedEventArgs set to true.

Se aplica a