PictureBox.LoadAsync Método

Definición

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

Sobrecargas

LoadAsync(String)

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

LoadAsync()

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

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

Ruta de acceso de la imagen que se va a mostrar en 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 Forms que contenga una PictureBox denominada pictureBox1 y una Button denominada 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 evento Click del botón está asociado con el método startLoadButton_Click 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 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 parámetro url 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 jpglocated ATC: \ se puede obtener acceso pasando c:\myPicture.jpg para el parámetro url.For example, an image file named myPicture.jpglocated atc:\ would be accessed by passing c:\myPicture.jpg for the url parameter. Se puede usar una ruta de acceso completa, como http://www.contoso.com/path/images/image.jpg, o una ruta de acceso relativa, como ./images/Image.jpg.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 usa 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 al método Load establece la propiedad ImageLocation en el valor de url.A call to the Load method sets the ImageLocation property to the value of url.

Una llamada al método LoadAsync establece la propiedad ImageLocation en el valor de url.A call to the LoadAsync method sets the ImageLocation property to the value of url. Además de llamar al método LoadAsync, debe establecer la propiedad WaitOnLoad en 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. Al cargar una imagen de forma asincrónica, puede controlar el evento LoadProgressChanged para determinar el progreso de la carga de una imagen o el evento LoadCompleted 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 de carga de imagen asincrónica, se detectará y se le informará de la propiedad Error 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()

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 de llamar al método LoadAsync, la propiedad WaitOnLoad 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. Al cargar una imagen de forma asincrónica, puede controlar el evento LoadProgressChanged para determinar el progreso de la carga de una imagen o el evento LoadCompleted 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