Partilhar via


WebPartManager.CreateErrorWebPart Método

Definição

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

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 de 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 o retorna. 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 Observações para herdadores.

Os usuários finais podem trabalhar com um ErrorWebPart controle em uma página da mesma forma que fariam com um controle normal WebPart . Para remover a mensagem de erro, eles podem fechar o controle clicando no verbo fechar. Nesse ponto, o controle será adicionado a um PageCatalogPart objeto, como qualquer outro controle fechado. Se um usuário final excluir um ErrorWebPart controle, o controle de 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 ErrorWebPart próprio controle herdando dele. Por exemplo, talvez você queira substituir sua Title propriedade ou AllowMinimize .

Aplica-se a

Confira também