PictureBox.CancelAsync Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Bricht das asynchrone Laden eines Bildes ab.

public:
 void CancelAsync();

public void CancelAsync ();

member this.CancelAsync : unit -> unit

Public Sub CancelAsync ()

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die CancelAsync-Methode verwenden. Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in ein Windows Form-Element ein, das ein benanntes PictureBoxpictureBox1 und zwei Button Steuerelemente mit dem Namen startLoadButton und cancelLoadButtonenthält. Stellen Sie sicher, dass das Click Ereignis für die Schaltflächen ihrer Ereignisbehandlungsmethode in diesem Beispiel zugeordnet ist. Sie müssen den Pfad der Imagedatei in einen Pfad ändern, der für Ihr System gültig ist.

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

Hinweise

Ein PictureBox Image wird asynchron geladen, wenn die WaitOnLoad -Eigenschaft ist false und die LoadAsync -Methode zum Laden des Images verwendet wird. Wenn ein Ladevorgang mit der CancelAsync Methode abgebrochen wird, wird gemeldet, indem das LoadCompleted -Ereignis mit der Cancelled -Eigenschaft des -Werts AsyncCompletedEventArgs auf trueausgelöst wird.