PictureBox.LoadAsync Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Ładuje obraz asynchronicznie.

Przeciążenia

LoadAsync(String)	Ładuje obraz w określonej lokalizacji asynchronicznie.
LoadAsync()	Ładuje obraz asynchronicznie.

LoadAsync(String)

Ładuje obraz w określonej lokalizacji asynchronicznie.

public:
 void LoadAsync(System::String ^ url);

public void LoadAsync (string url);

member this.LoadAsync : string -> unit

Public Sub LoadAsync (url As String)

Parametry

url

String

Ścieżka obrazu do wyświetlenia w obiekcie PictureBox.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać LoadAsync metody . Aby uruchomić ten przykład, wklej następujący kod w formularzu Windows zawierającym PictureBox nazwę pictureBox1 i Button nazwę startLoadButton. Upewnij się, że Click zdarzenie przycisku jest skojarzone z startLoadButton_Click metodą w tym przykładzie. Należy zmienić ścieżkę pliku obrazu na ścieżkę prawidłową w systemie.

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

Uwagi

url Jeśli parametr wskazuje plik lokalny, zalecanym formatem jest ścieżka pliku lokalnego. Na przykład plik obrazu o nazwie myPicture.jpglocated atc:\ dostęp do tego parametru można uzyskać, przekazując c:\myPicture.jpg dla parametru url . Można użyć pełnej ścieżki, takiej jak , lub ścieżki względnej, takiej jak http://www.contoso.com/path/images/image.jpg./images/image.jpg. Jeśli jest używana ścieżka względna, zostanie ona uznana za względną dla katalogu roboczego. Wywołanie metody Load ustawia ImageLocation właściwość na wartość url.

Wywołanie metody LoadAsync ustawia ImageLocation właściwość na wartość url. Oprócz wywołania LoadAsync metody należy ustawić WaitOnLoad właściwość tak, aby false ładowała obraz asynchronicznie. Podczas ładowania obrazu asynchronicznie można obsłużyć LoadProgressChanged zdarzenie w celu określenia postępu ładowania obrazu lub LoadCompleted zdarzenia w celu określenia, kiedy ładowanie obrazu zostało zakończone. Jeśli podczas operacji ładowania obrazu asynchronicznego wystąpi błąd, zostanie przechwycony i zgłoszony przez Error właściwość AsyncCompletedEventArgs.

LoadAsync()

Ładuje obraz asynchronicznie.

public:
 void LoadAsync();

public void LoadAsync ();

member this.LoadAsync : unit -> unit

Public Sub LoadAsync ()

Uwagi

Oprócz wywoływania LoadAsync metody właściwość musi być ustawiona tak, WaitOnLoad aby false ładowała obraz asynchronicznie. Podczas ładowania obrazu asynchronicznie można obsłużyć LoadProgressChanged zdarzenie w celu określenia postępu ładowania obrazu lub LoadCompleted zdarzenia w celu określenia, kiedy ładowanie obrazu zostało zakończone.