PictureBox.LoadAsync Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Lädt das Bild asynchron.

Überlädt

LoadAsync(String)	Lädt das Bild am angegebenen Speicherort asynchron.
LoadAsync()	Lädt das Bild asynchron.

LoadAsync(String)

Lädt das Bild am angegebenen Speicherort asynchron.

public:
 void LoadAsync(System::String ^ url);

public void LoadAsync (string url);

member this.LoadAsync : string -> unit

Public Sub LoadAsync (url As String)

Parameter

url

String

Der Pfad des Bildes, das in der PictureBox angezeigt werden soll.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die LoadAsync-Methode verwenden. Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in ein Windows Formular ein, das einen Benannten und einen Button PictureBox Benannten pictureBox1 startLoadButtonenthält. Stellen Sie sicher, dass das Click Ereignis für die Schaltfläche der startLoadButton_Click Methode in diesem Beispiel zugeordnet ist. Sie müssen den Bilddateipfad 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

Hinweise

Wenn der Parameter eine lokale Datei angibt, ist das url empfohlene Format ein lokaler Dateipfad. Beispiel: Eine Bilddatei namens myPicture.jpglocated atc:\ wird durch Übergeben von c:\myPicture.jpg für den url Parameter zugegriffen. Ein vollständiger Pfad, z. B. ein relativer Pfad, z http://www.contoso.com/path/images/image.jpg. B. ./images/image.jpg, kann verwendet werden. Wenn ein relativer Pfad verwendet wird, wird er relativ zum Arbeitsverzeichnis betrachtet. Ein Aufruf der Load Methode legt die ImageLocation Eigenschaft auf den Wert von url.

Ein Aufruf der LoadAsync Methode legt die ImageLocation Eigenschaft auf den Wert von url. Neben dem Aufrufen der LoadAsync Methode müssen Sie die WaitOnLoad Eigenschaft false so festlegen, dass ein Bild asynchron geladen wird. Wenn Sie ein Bild asynchron laden, können Sie das LoadProgressChanged Ereignis behandeln, um den Status eines Bildladevorgangs oder das LoadCompleted Ereignis zu bestimmen, um zu bestimmen, wann eine Bildlast abgeschlossen wurde. Wenn ein Fehler während eines asynchronen Bildladevorgangs auftritt, wird er von der Error Eigenschaft der AsyncCompletedEventArgsDatei erfasst und gemeldet.

LoadAsync()

Lädt das Bild asynchron.

public:
 void LoadAsync();

public void LoadAsync ();

member this.LoadAsync : unit -> unit

Public Sub LoadAsync ()

Hinweise

Neben dem Aufrufen der LoadAsync Methode muss die WaitOnLoad Eigenschaft auf false das asynchrone Laden eines Bilds festgelegt werden. Wenn Sie ein Bild asynchron laden, können Sie das LoadProgressChanged Ereignis behandeln, um den Status eines Bildladevorgangs oder das LoadCompleted Ereignis zu bestimmen, um zu bestimmen, wann eine Bildlast abgeschlossen wurde.