PictureBox.CancelAsync Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Annulla il caricamento asincrono di un'immagine.

public:
 void CancelAsync();

public void CancelAsync ();

member this.CancelAsync : unit -> unit

Public Sub CancelAsync ()

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo CancelAsync. Per eseguire questo esempio, incollare il codice seguente in un Windows Form contenente un PictureBox oggetto denominato e due Button controlli denominati pictureBox1startLoadButton e cancelLoadButton. Assicurarsi che l'evento Click per i pulsanti sia associato al metodo di gestione degli eventi in questo esempio. È necessario modificare il percorso del file di immagine in un percorso valido nel 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

Commenti

Un'immagine PictureBox viene caricata in modo asincrono quando la WaitOnLoad proprietà è false e il LoadAsync metodo viene usato per caricare l'immagine. Se un carico viene annullato con l'annullamento del CancelAsync metodo viene segnalato generando l'evento LoadCompleted con la Cancelled proprietà del AsyncCompletedEventArgs set su true.