WebPartManager.CreateErrorWebPart Método

Referência

Definição

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Cria um controle especial que é inserido em uma página e exibido para usuários finais, quando uma tentativa de carregar ou criar um controle WebPart dinâmico falha por alguma razão.

protected:
 virtual System::Web::UI::WebControls::WebParts::ErrorWebPart ^ CreateErrorWebPart(System::String ^ originalID, System::String ^ originalTypeName, System::String ^ originalPath, System::String ^ genericWebPartID, System::String ^ errorMessage);

protected virtual System.Web.UI.WebControls.WebParts.ErrorWebPart CreateErrorWebPart (string originalID, string originalTypeName, string originalPath, string genericWebPartID, string errorMessage);

abstract member CreateErrorWebPart : string * string * string * string * string -> System.Web.UI.WebControls.WebParts.ErrorWebPart
override this.CreateErrorWebPart : string * string * string * string * string -> System.Web.UI.WebControls.WebParts.ErrorWebPart

Protected Overridable Function CreateErrorWebPart (originalID As String, originalTypeName As String, originalPath As String, genericWebPartID As String, errorMessage As String) As ErrorWebPart

Parâmetros

originalID: String

Uma cadeia de caracteres que é a ID do controle com falha. Se um GenericWebPart estiver envolvido na falha, a ID será a ID do controle de servidor filho.

originalTypeName: String

Uma cadeia de caracteres que é o nome do Type do controle com falha. Se um GenericWebPart estiver envolvido na falha, o nome do tipo será o tipo do controle de servidor filho.

originalPath: String

Uma cadeia de caracteres que contém o caminho para um controle de usuário, se um GenericWebPart que contém um controle de usuário filho estiver envolvido na falha.

genericWebPartID: String

Uma cadeia de caracteres que retorna a ID de um GenericWebPart, se esse tipo de controle estava envolvido na falha ao carregar ou criar um controle.

errorMessage: String

Uma cadeia de caracteres que contém a mensagem de erro a ser exibida na página.

Retornos

ErrorWebPart

Um ErrorWebPart que é inserido em uma página no lugar de um controle que falhou ao ser carregado ou criado.

Comentários

O CreateErrorWebPart método é chamado quando o conjunto de controle Web Parts tenta carregar ou criar uma instância de um controle dinâmico WebPart ou de servidor e falha por algum motivo. O método cria um ErrorWebPart objeto, atribui uma mensagem de erro a ele e retorna-o. O ErrorWebPart controle é inserido no lugar do controle que falhou e sua mensagem de erro é exibida na página.

Você não pode chamar o CreateErrorWebPart método diretamente do seu código. No entanto, você pode herdar da WebPartManager classe e estender o método. Para obter detalhes, consulte a seção Anotações para Herdadores.

Os usuários finais podem trabalhar com um ErrorWebPart controle em uma página como se fossem um controle normal WebPart . Para remover a mensagem de erro, eles podem fechar o controle clicando no verbo de fechamento, momento em que o controle será adicionado a um PageCatalogPart objeto, como qualquer outro controle fechado. Se um usuário final excluir um ErrorWebPart controle, o controle do servidor que não foi carregado também será excluído da página.

Notas aos Herdeiros

Se você quiser personalizar as informações retornadas no ErrorWebPart controle, poderá substituir o CreateErrorWebPart(String, String, String, String, String) método, chamar o método base, atribuir valores diferentes aos parâmetros passados para o método base e retornar o controle resultante ErrorWebPart . Por exemplo, se você não quiser que os usuários finais vejam o originalPath valor (que mostraria o caminho do diretório virtual de um controle de usuário), ao chamar o método base, você poderá passar uma cadeia de caracteres vazia ("") para esse parâmetro.

Você também pode personalizar o comportamento do próprio controle herdando-o ErrorWebPart . Por exemplo, talvez você queira substituir sua propriedade ou AllowMinimize propriedadeTitle.

Aplica-se a