PictureBox.LoadAsync Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Charge l'image de manière asynchrone.

Surcharges

LoadAsync(String)	Charge l'image à l'emplacement spécifié, de façon asynchrone.
LoadAsync()	Charge l'image de manière asynchrone.

LoadAsync(String)

Charge l'image à l'emplacement spécifié, de façon asynchrone.

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

public void LoadAsync (string url);

member this.LoadAsync : string -> unit

Public Sub LoadAsync (url As String)

Paramètres

url

String

Chemin d'accès de l'image à afficher dans PictureBox.

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode LoadAsync. Pour exécuter cet exemple, collez le code suivant dans un formulaire Windows qui contient un PictureBox nom pictureBox1 et un Button nommé startLoadButton. Vérifiez que l’événement Click du bouton est associé à la startLoadButton_Click méthode dans cet exemple. Vous devez remplacer le chemin d’accès du fichier image par un chemin valide sur votre système.

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

Remarques

Si le url paramètre indique un fichier local, le format recommandé est un chemin d’accès au fichier local. Par exemple, un fichier image nommé myPicture.jpglocated atc:\ est accessible en passant c:\myPicture.jpg pour le url paramètre. Un chemin d’accès complet, tel que http://www.contoso.com/path/images/image.jpg, ou un chemin relatif, tel que ./images/image.jpg, peut être utilisé. Si un chemin d’accès relatif est utilisé, il est considéré par rapport au répertoire de travail. Un appel à la Load méthode définit la ImageLocation propriété sur la valeur de url.

Un appel à la LoadAsync méthode définit la ImageLocation propriété sur la valeur de url. En plus d’appeler la LoadAsync méthode, vous devez définir la WaitOnLoad propriété pour false charger une image de manière asynchrone. Lorsque vous chargez une image de façon asynchrone, vous pouvez gérer l’événement LoadProgressChanged pour déterminer la progression d’une charge d’image ou l’événement LoadCompleted pour déterminer quand une charge d’image est terminée. Si une erreur se produit pendant une opération de chargement d’image asynchrone, elle est interceptée et signalée par la Error propriété du AsyncCompletedEventArgs.

LoadAsync()

Charge l'image de manière asynchrone.

public:
 void LoadAsync();

public void LoadAsync ();

member this.LoadAsync : unit -> unit

Public Sub LoadAsync ()

Remarques

Outre l’appel de la LoadAsync méthode, la WaitOnLoad propriété doit être définie pour false charger une image de manière asynchrone. Lorsque vous chargez une image de façon asynchrone, vous pouvez gérer l’événement LoadProgressChanged pour déterminer la progression d’une charge d’image ou l’événement LoadCompleted pour déterminer quand une charge d’image est terminée.