PictureBox.LoadAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.
S’applique à
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.