PictureBox.CancelAsync Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Cancela una carga de la imagen asincrónica.

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. Para ejecutar este ejemplo, pegue el código siguiente en un formulario Windows Forms que contenga un denominado PictureBoxpictureBox1 y dos Button controles denominados startLoadButton y cancelLoadButton. Asegúrese de que el Click evento de los botones está asociado a su método de control de eventos en este ejemplo. Debe cambiar la ruta de acceso del archivo de imagen a una ruta de acceso válida en el sistema.

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 PictureBox imagen se carga de forma asincrónica cuando la WaitOnLoad propiedad es false y el LoadAsync método se usa para cargar la imagen. Si se cancela una carga con la cancelación del CancelAsync método se notifica generando el LoadCompleted evento con la Cancelled propiedad del AsyncCompletedEventArgs establecido en true.