PictureBox.LoadAsync PictureBox.LoadAsync PictureBox.LoadAsync PictureBox.LoadAsync Method

Definición

Carga la imagen de forma asincrónica.Loads the image asynchronously.

Sobrecargas

LoadAsync(String) LoadAsync(String) LoadAsync(String) LoadAsync(String)

Carga la imagen en la ubicación especificada, de forma asincrónica.Loads the image at the specified location, asynchronously.

LoadAsync() LoadAsync() LoadAsync() LoadAsync()

Carga la imagen de forma asincrónica.Loads the image asynchronously.

LoadAsync(String) LoadAsync(String) LoadAsync(String) LoadAsync(String)

Carga la imagen en la ubicación especificada, de forma asincrónica.Loads the image at the specified location, asynchronously.

public:
 void LoadAsync(System::String ^ url);
public void LoadAsync (string url);
member this.LoadAsync : string -> unit
Public Sub LoadAsync (url As String)

Parámetros

url
String String String String

La ruta de acceso para la imagen que se muestra en el PictureBox.The path for the image to display in the PictureBox.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método LoadAsync.The following code example demonstrates how to use the LoadAsync method. Para ejecutar este ejemplo, pegue el código siguiente en un formulario de Windows que contenga un PictureBox denominado pictureBox1 y un Button denominado startLoadButton.To run this example, paste the following code into a Windows Form that contains a PictureBox named pictureBox1 and a Button named startLoadButton. Asegúrese de que el Click eventos para el botón está asociado con el startLoadButton_Click método en este ejemplo.Make sure that the Click event for the button is associated with the startLoadButton_Click method in this example. Debe cambiar la ruta de acceso del archivo de imagen a una ruta de acceso es válida en el sistema.You must change the image file path to a path that is valid on your system.

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

Comentarios

Si el url parámetro indica un archivo local, el formato recomendado es una ruta de acceso de archivo local.If the url parameter indicates a local file, the recommended format is a local file path. Por ejemplo, un archivo de imagen denominado myPicture.jpglocated atc: \ sería se tiene acceso pasando c:\myPicture.jpg para el url parámetro.For example, an image file named myPicture.jpglocated atc:\ would be accessed by passing c:\myPicture.jpg for the url parameter. Una ruta de acceso completa, como http://www.contoso.com/path/images/image.jpg, o una ruta de acceso relativa, como ./images/image.jpg, se puede usar.A full path, such as http://www.contoso.com/path/images/image.jpg, or a relative path, such as ./images/image.jpg, can be used. Si se utiliza una ruta de acceso relativa, se considerará relativa al directorio de trabajo.If a relative path is used, it will be considered relative to the working directory. Una llamada a la Load método establece el ImageLocation en el valor de url.A call to the Load method sets the ImageLocation property to the value of url.

Una llamada a la LoadAsync método establece el ImageLocation en el valor de url.A call to the LoadAsync method sets the ImageLocation property to the value of url. Además una llamada a la LoadAsync método, debe establecer el WaitOnLoad propiedad false para cargar una imagen de forma asincrónica.Besides calling the LoadAsync method, you must set the WaitOnLoad property to false to load an image asynchronously. Cuando se carga una imagen de forma asincrónica, puede controlar la LoadProgressChanged evento para determinar el progreso de carga de una imagen o el LoadCompleted evento para determinar cuándo se ha completado una carga de la imagen.When you load an image asynchronously, you can handle the LoadProgressChanged event to determine the progress of an image load or the LoadCompleted event to determine when an image load has completed. Si se produce un error durante una operación asincrónica de carga de la imagen, se detectan y notificado por el Error propiedad de la AsyncCompletedEventArgs.If an error occurs during an asynchronous image-loading operation, it will be caught and reported by the Error property of the AsyncCompletedEventArgs.

LoadAsync() LoadAsync() LoadAsync() LoadAsync()

Carga la imagen de forma asincrónica.Loads the image asynchronously.

public:
 void LoadAsync();
public void LoadAsync ();
member this.LoadAsync : unit -> unit
Public Sub LoadAsync ()

Comentarios

Además, una llamada a la LoadAsync método, el WaitOnLoad propiedad debe establecerse en false para cargar una imagen de forma asincrónica.Besides calling the LoadAsync method, the WaitOnLoad property must be set to false to load an image asynchronously. Cuando se carga una imagen de forma asincrónica, puede controlar la LoadProgressChanged evento para determinar el progreso de carga de una imagen o el LoadCompleted evento para determinar cuándo se ha completado una carga de la imagen.When you load an image asynchronously, you can handle the LoadProgressChanged event to determine the progress of an image load or the LoadCompleted event to determine when an image load has completed.

Se aplica a