PictureBox.CancelAsync PictureBox.CancelAsync PictureBox.CancelAsync PictureBox.CancelAsync Method

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 que contenga un PictureBox denominado pictureBox1 y dos Button controles 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 Click evento para 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 es 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

Un PictureBox imagen se carga asincrónicamente cuando la WaitOnLoad propiedad es false y LoadAsync método se usa 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 cancelación del método se notifica al elevar la LoadCompleted evento con el Cancelled propiedad de la AsyncCompletedEventArgs establecido 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