PictureBox.LoadCompleted 事件

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

在异步图像加载操作完成、取消或引发异常时发生。

public:
 event System::ComponentModel::AsyncCompletedEventHandler ^ LoadCompleted;

public event System.ComponentModel.AsyncCompletedEventHandler LoadCompleted;

member this.LoadCompleted : System.ComponentModel.AsyncCompletedEventHandler 

Public Custom Event LoadCompleted As AsyncCompletedEventHandler 

事件类型

AsyncCompletedEventHandler

示例

下面的代码示例演示了此成员的用法。 在此示例中，事件处理程序报告事件的发生情况 LoadCompleted 。 此报告可帮助你了解事件发生的时间，并可以帮助你进行调试。 若要报告多个事件或频繁发生的事件，请考虑将 MessageBox.ShowConsole.WriteLine 消息替换为 或将消息追加到多行 TextBox。

若要运行示例代码，请将其粘贴到包含名为 PictureBox1的类型的PictureBox实例的项目中。 然后，确保事件处理程序与 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" );
}

Private Sub PictureBox1_LoadCompleted(sender as Object, e as AsyncCompletedEventArgs) _ 
     Handles PictureBox1.LoadCompleted

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Cancelled", e.Cancelled)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Error", e.Error)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "UserState", e.UserState)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"LoadCompleted Event")

End Sub

注解

LoadCompleted仅当使用 方法之一LoadAsync异步加载映像且 WaitOnLoad 为 false时，才会发生 。 如果通过调用 CancelAsync 方法取消图像加载， Cancelled 的 AsyncCompletedEventArgs 属性将设置为 true。 如果在加载过程中发生异常或错误，则会捕获该异常或错误， Error 并且 的 AsyncCompletedEventArgs 属性将包含异常信息。

有关处理事件的详细信息，请参阅 处理和引发事件。