Questa documentazione è stata archiviata e non viene gestita.

Evento PictureBox.LoadCompleted

Aggiornamento: novembre 2007

Si verifica quando un'operazione di caricamento asincrono di un'immagine è stata completata, è stata annullata oppure ha generato un'eccezione.

Spazio dei nomi:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public event AsyncCompletedEventHandler LoadCompleted
/** @event */
public void add_LoadCompleted (AsyncCompletedEventHandler value)
/** @event */
public void remove_LoadCompleted (AsyncCompletedEventHandler value)

JScript non supporta gli eventi.

L'evento LoadCompleted si verifica soltanto quando l'immagine viene caricata in modo asincrono utilizzando uno dei metodi LoadAsync e la proprietà WaitOnLoad è false. Se il caricamento dell'immagine viene annullato chiamando il metodo CancelAsync, la proprietà Cancelled della classe AsyncCompletedEventArgs sarà impostata su true. Se, in fase di caricamento, viene generata un'eccezione o un errore, sarà individuato e la proprietà Error dell'oggetto AsyncCompletedEventArgs conterrà le informazioni sull'eccezione.

Per ulteriori informazioni sulla gestione di eventi, vedere Utilizzo degli eventi.

Nell'esempio di codice riportato di seguito viene illustrato l'utilizzo di questo membro. Nell'esempio, un gestore eventi genera report sull'occorrenza dell'evento LoadCompleted. Questo report consente di capire quando si verifica l'evento offrendo un supporto per il debug. Per generare report su più eventi o su eventi che si verificano frequentemente, sostituire MessageBox.Show con Console.WriteLine o aggiungere il messaggio a un controllo TextBox su più righe.

Per eseguire il codice di esempio, incollarlo in un progetto che contenga un'istanza di tipo PictureBox denominata PictureBox1. Assicurarsi quindi che il gestore eventi sia associato all'evento LoadCompleted.

private void PictureBox1_LoadCompleted(Object sender, AsyncCompletedEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Cancelled", e.Cancelled );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Error", e.Error );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "UserState", e.UserState );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "LoadCompleted Event" );
}


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition , Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5, 3.0, 2.0
Mostra: