ControlDesigner.GetErrorDesignTimeHtml(Exception) 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.
Recupera a marcação HTML que fornece informações sobre a exceção especificada.
protected:
virtual System::String ^ GetErrorDesignTimeHtml(Exception ^ e);
protected virtual string GetErrorDesignTimeHtml(Exception e);
abstract member GetErrorDesignTimeHtml : Exception -> string
override this.GetErrorDesignTimeHtml : Exception -> string
Protected Overridable Function GetErrorDesignTimeHtml (e As Exception) As String
Parâmetros
A exceção que ocorreu.
Devoluções
A marcação HTML em tempo de design para a exceção especificada.
Exemplos
O exemplo de código seguinte demonstra como gerar marcação HTML em tempo de projeto para o controlo quando ocorre um erro e chamar o CreatePlaceHolderDesignTimeHtml método.
// Generate the design-time markup for the control when an error occurs.
protected override string GetErrorDesignTimeHtml(Exception e)
{
// Write the error message text in red, bold.
string errorRendering =
"<span style=\"font-weight:bold; color:Red; \">" +
e.Message + "</span>";
return CreatePlaceHolderDesignTimeHtml(errorRendering);
} // GetErrorDesignTimeHtml
' Generate the design-time markup for the control when an error occurs.
Protected Overrides Function GetErrorDesignTimeHtml( _
ByVal ex As Exception) As String
' Write the error message text in red, bold.
Dim errorRendering As String = _
"<span style=""font-weight:bold; color:Red; "">" & _
ex.Message & "</span>"
Return CreatePlaceHolderDesignTimeHtml(errorRendering)
End Function ' GetErrorDesignTimeHtml
Observações
O GetErrorDesignTimeHtml método é normalmente chamado se for feita uma exceção no GetDesignTimeHtml método.
Notas para Herdeiros
O padrão típico de design é tentar obter marcação HTML através do controlo associado e, se for encontrado um erro, chamar o GetErrorDesignTimeHtml(Exception) método. Se não for devolvida nenhuma marcação pelo controlo, chama o GetEmptyDesignTimeHtml() método, que, se não for sobreposto para fornecer marcação específica, chama o CreatePlaceHolderDesignTimeHtml() método, que deverá conter informações sobre o tipo e o ID do controlo.