PictureBox.CancelAsync Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Cancela uma carga de imagem assíncrona.

public:
 void CancelAsync();

public void CancelAsync ();

member this.CancelAsync : unit -> unit

Public Sub CancelAsync ()

Exemplos

O exemplo de código a seguir demonstra como usar o CancelAsync método . Para executar este exemplo, cole o código a seguir em um Windows Form que contém um PictureBox nomeado e dois Button controles chamados startLoadButton e cancelLoadButtonpictureBox1 . Verifique se o Click evento para os botões está associado ao método de manipulação de eventos neste exemplo. Você deve alterar o caminho do arquivo de imagem para um caminho válido em seu 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

Comentários

Uma PictureBox imagem é carregada de forma assíncrona quando a WaitOnLoad propriedade é false e o LoadAsync método é usado para carregar a imagem. Se uma carga for cancelada com o cancelamento do método, será CancelAsync relatado acionando o LoadCompleted evento com a Cancelled propriedade do AsyncCompletedEventArgs definido como true.