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. Um dieses Beispiel auszuführen, fügen Sie den folgenden Code in ein Windows Formular ein, das einen PictureBox benannten pictureBox1 und zwei Steuerelemente namens startLoadButton und cancelLoadButton.Button Stellen Sie sicher, dass das Click Ereignis für die Schaltflächen der Ereignisbehandlungsmethode in diesem Beispiel zugeordnet ist. Sie müssen den Pfad der Bilddatei in einen Pfad ändern, der auf Ihrem 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 Bild wird asynchron geladen, wenn die WaitOnLoad Eigenschaft vorhanden ist false und die LoadAsync Methode zum Laden des Bilds verwendet wird. Wenn eine Lade mit der CancelAsync Methodenabbruch abgebrochen wird, wird durch Auslösen des LoadCompleted Ereignisses mit der Cancelled Eigenschaft des AsyncCompletedEventArgs Festgelegten auf true.