PictureBox.LoadAsync Método

Definição

Carrega a imagem de maneira assíncrona.Loads the image asynchronously.

Sobrecargas

LoadAsync(String)

Carrega a imagem no local especificado, de maneira assíncrona.Loads the image at the specified location, asynchronously.

LoadAsync()

Carrega a imagem de maneira assíncrona.Loads the image asynchronously.

LoadAsync(String)

Carrega a imagem no local especificado, de maneira assíncrona.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

O caminho para a imagem a exibir no PictureBox.The path for the image to display in the PictureBox.

Exemplos

O exemplo de código a seguir demonstra como usar LoadAsync o método.The following code example demonstrates how to use the LoadAsync method. Para executar este exemplo, Cole o código a seguir em um formulário do Windows que PictureBox contenha um Button nome startLoadButton pictureBox1 e um nomeado.To run this example, paste the following code into a Windows Form that contains a PictureBox named pictureBox1 and a Button named startLoadButton. Certifique-se de Click que o evento para o botão esteja associado startLoadButton_Click ao método neste exemplo.Make sure that the Click event for the button is associated with the startLoadButton_Click method in this example. Você deve alterar o caminho do arquivo de imagem para um caminho que seja válido em seu 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

Comentários

Se o url parâmetro indicar um arquivo local, o formato recomendado é um caminho de arquivo local.If the url parameter indicates a local file, the recommended format is a local file path. Por exemplo, um arquivo de imagem chamado myPicture. jpglocated ATC: \ seria acessado passando c:\myPicture.jpg para o url parâmetro.For example, an image file named myPicture.jpglocated atc:\ would be accessed by passing c:\myPicture.jpg for the url parameter. Um caminho completo, **http://www.contoso.com/path/images/image.jpg**como, ou um caminho relativo, como ./images/Image.jpg, pode ser usado.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. Se um caminho relativo for usado, ele será considerado relativo ao diretório de trabalho.If a relative path is used, it will be considered relative to the working directory. Uma chamada para o Load método define a ImageLocation Propriedade como o valor de url.A call to the Load method sets the ImageLocation property to the value of url.

Uma chamada para o LoadAsync método define a ImageLocation Propriedade como o valor de url.A call to the LoadAsync method sets the ImageLocation property to the value of url. Além de chamar LoadAsync o método, você deve definir WaitOnLoad a propriedade false como para carregar uma imagem de forma assíncrona.Besides calling the LoadAsync method, you must set the WaitOnLoad property to false to load an image asynchronously. Ao carregar uma imagem de forma assíncrona, você pode LoadProgressChanged manipular o evento para determinar o progresso de um carregamento de LoadCompleted imagem ou o evento para determinar quando um carregamento de imagem foi concluído.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 ocorrer um erro durante uma operação de carregamento de imagem assíncrona, ele será capturado e relatado pela Error propriedade AsyncCompletedEventArgsdo.If an error occurs during an asynchronous image-loading operation, it will be caught and reported by the Error property of the AsyncCompletedEventArgs.

LoadAsync()

Carrega a imagem de maneira assíncrona.Loads the image asynchronously.

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

Comentários

Além de chamar LoadAsync o método, WaitOnLoad a propriedade deve ser definida false como para carregar uma imagem de forma assíncrona.Besides calling the LoadAsync method, the WaitOnLoad property must be set to false to load an image asynchronously. Ao carregar uma imagem de forma assíncrona, você pode LoadProgressChanged manipular o evento para determinar o progresso de um carregamento de LoadCompleted imagem ou o evento para determinar quando um carregamento de imagem foi concluído.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.

Aplica-se a