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 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 evento del botón está asociado al 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 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.jpgencuentra ATC: \ se puede obtener acceso al pasar 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. 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 Load método establece la ImageLocation propiedad en el valor de url .A call to the Load method sets the ImageLocation property to the value of url.

Una llamada al LoadAsync método establece la ImageLocation propiedad 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 LoadAsync método, debe establecer la WaitOnLoad propiedad 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 LoadProgressChanged evento para determinar el progreso de una carga de imagen o el LoadCompleted evento para determinar cuándo se ha completado la carga de una 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 mostrará en la Error propiedad de AsyncCompletedEventArgs .If an error occurs during an asynchronous image-loading operation, it will be caught and reported by the Error property of the AsyncCompletedEventArgs.

Se aplica a

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 LoadAsync método, la WaitOnLoad propiedad se debe establecer 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 LoadProgressChanged evento para determinar el progreso de una carga de imagen o el LoadCompleted evento para determinar cuándo se ha completado la carga de una 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