BasicDesignerLoader.OnEndLoad(Boolean, ICollection) Método

Definição

Namespace:

System.ComponentModel.Design.Serialization

Assembly:

System.Windows.Forms.Design.dll

Notifica o carregador do designer de que o carregamento foi concluído.

protected:
 virtual void OnEndLoad(bool successful, System::Collections::ICollection ^ errors);

protected virtual void OnEndLoad (bool successful, System.Collections.ICollection errors);

abstract member OnEndLoad : bool * System.Collections.ICollection -> unit
override this.OnEndLoad : bool * System.Collections.ICollection -> unit

Protected Overridable Sub OnEndLoad (successful As Boolean, errors As ICollection)

Parâmetros

successful

Boolean

true se o carregamento tiver sido concluído com êxito; caso contrário, false.

errors

ICollection

Um ICollection que contém objetos (geralmente exceções) relatados como erros.

Exceções

InvalidOperationException

O IDesignerLoaderHost não foi inicializado.

ObjectDisposedException

O IDesignerLoaderHost foi descartado.

Comentários

O OnEndLoad método é invocado quando o carregamento é concluído. Ele é sempre chamado, mesmo que uma exceção seja gerada durante o carregamento. O valor de successful será definido true como se a carga tiver sido bem-sucedida ou false se ocorreu um erro fatal. A errors coleção conterá objetos que foram relatados como erros. Normalmente, esses objetos são exceções.

Se você implementar IDesignerLoaderService para fornecer suporte de carga dependente, deverá chamar o OnEndLoad método após a última chamada para o IDesignerLoaderService.DependentLoadComplete método . Por padrão, BasicDesignerLoader implementa IDesignerLoaderService e faz isso para você. Se IDesignerLoaderService não estiver disponível quando BeginLoad for chamado, BeginLoad chamará OnEndLoad diretamente depois de chamar PerformLoad.

Esse método deve ser chamado pelo serviço de carregador do designer quando todas as cargas dependentes tiverem sido concluídas. Isso interrompe o processo de carregamento iniciado pelo BeginLoad método . Se você fornecer seu próprio serviço de carregador ou se optar por não fornecer um serviço de carregador, será responsável por chamar esse método. O BeginLoad método chamará isso automaticamente, indiretamente chamando o IDesignerLoaderService.DependentLoadComplete método se IDesignerLoaderService estiver disponível ou diretamente se não estiver.