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

Definição

Cancela uma carga de imagem assíncrona.Cancels an asynchronous image load.

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 CancelAsync o método.The following code example demonstrates how to use the CancelAsync method. Para executar este exemplo, Cole o código a seguir em um formulário do Windows que PictureBox contenha um Button pictureBox1 e dois startLoadButton controles cancelLoadButtonnomeados e.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. Verifique se o Click evento dos botões está associado ao seu método de manipulação de eventos neste exemplo.Make sure that the Click event for the buttons is associated with their event-handling method in this example. Você deve alterar o caminho do arquivo de imagem para um caminho que seja válido em seu 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

Comentários

Uma PictureBox imagem é carregada de forma assíncrona quando false a WaitOnLoad propriedade LoadAsync é e o método é usado para carregar a imagem.A PictureBox image is loaded asynchronously when the WaitOnLoad property is false and the LoadAsync method is used to load the image. Se uma carga for cancelada CancelAsync com o método cancelamento é relatado, LoadCompleted gerando o Cancelled evento AsyncCompletedEventArgs com a propriedade do trueconjunto como.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.

Aplica-se a