WebPartManager.CreateErrorWebPart Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Cria um controlo especial que é inserido numa página e exibido para os utilizadores finais quando uma tentativa de carregar ou criar um controlo dinâmico WebPart falha por algum motivo.
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.ErrorWebPartProtected Overridable Function CreateErrorWebPart (originalID As String, originalTypeName As String, originalPath As String, genericWebPartID As String, errorMessage As String) As ErrorWebPartParâmetros
- originalID
- String
Uma cadeia que é o ID do controlo que falha. Se a GenericWebPart estiver envolvido na falha, o ID é o ID do seu servidor filho de controlo.
- originalTypeName
- String
Uma cadeia que é o nome do Type controlo falhado. Se a GenericWebPart estiver envolvido na falha, o nome do tipo é o tipo de controlo do seu servidor filho.
- originalPath
- String
Uma cadeia que contém o caminho para um controlo de utilizador, se um GenericWebPart que contém um controlo de utilizador filho, está envolvida na falha.
- genericWebPartID
- String
Uma cadeia que devolve o ID de um GenericWebPart, se esse tipo de controlo esteve envolvido na falha em carregar ou criar um controlo.
- errorMessage
- String
Uma cadeia que contém a mensagem de erro para mostrar na página.
Devoluções
Um ErrorWebPart que é inserido numa página em vez de um controlo que não foi carregado ou criado.
Observações
O CreateErrorWebPart método é chamado quando o conjunto de controlo Web Parts tenta carregar ou criar uma instância de um controlo dinâmico WebPart ou de servidor, e falha por algum motivo. O método cria um ErrorWebPart objeto, atribui-lhe uma mensagem de erro e devolve-o. O ErrorWebPart controlo é inserido no lugar do controlo que falhou, e a sua mensagem de erro é exibida na página.
Não podes chamar o CreateErrorWebPart método diretamente do teu código. No entanto, podes herdar da WebPartManager classe e estender o método. Para mais detalhes, consulte a secção Notas para Herdeiros.
Os utilizadores finais podem trabalhar com um ErrorWebPart controlo numa página tal como trabalhariam com um controlo normal WebPart . Para remover a mensagem de erro, podem fechar o controlo clicando no verbo fechar, momento em que o controlo será adicionado a um PageCatalogPart objeto, como qualquer outro controlo fechado. Se um utilizador final eliminar um ErrorWebPart controlo, o controlo do servidor que falhou ao carregar também será eliminado da página.
Notas para Herdeiros
Se quiser personalizar a informação devolvida no ErrorWebPart controlo, pode sobrepor o CreateErrorWebPart(String, String, String, String, String) método, chamar o método base, atribuir valores diferentes aos parâmetros passados ao método base e depois devolver o controlo resultante ErrorWebPart . Por exemplo, se não quiser que os utilizadores finais vejam o originalPath valor (que mostraria o caminho virtual do diretório de um controlo de utilizador), ao chamar o método base pode passar uma string vazia ("") para esse parâmetro.
Também pode personalizar o comportamento do ErrorWebPart próprio controlo, herdando dele. Por exemplo, pode querer sobrepor-se à sua Title ou AllowMinimize propriedade.