PictureBox.CancelAsync Método

Definição

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 seguinte demonstra como usar o CancelAsync método. Para executar este exemplo, cole o seguinte código num Windows Form que contém um PictureBox chamado pictureBox1 e dois controlos Button chamados startLoadButton e cancelLoadButton. Certifique-se de que o Click evento dos botões está associado ao seu método de gestão de eventos neste exemplo. Deve alterar o caminho do ficheiro de imagem para um caminho válido no 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

Observações

Uma PictureBox imagem é carregada de forma assíncrona quando a WaitOnLoad propriedade está false e o LoadAsync método é usado para carregar a imagem. Se uma carga for cancelada com o CancelAsync método o cancelamento é reportado elevando o LoadCompleted evento com a Cancelled propriedade do AsyncCompletedEventArgs conjunto para true.

Aplica-se a