ControlDesigner.GetErrorDesignTimeHtml(Exception) Método
Definição
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.
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.
Retornos
A marcação HTML de tempo de design da exceção especificada.
Exemplos
O exemplo de código a seguir demonstra como gerar marcação HTML em tempo de design para o controle 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
Comentários
O GetErrorDesignTimeHtml método normalmente é chamado, se uma exceção é gerada no GetDesignTimeHtml método .
Notas aos Herdeiros
O padrão de design típico é tentar obter a marcação HTML por meio do controle associado e, em seguida, se um erro for encontrado, chame o GetErrorDesignTimeHtml(Exception) método . Se nenhuma marcação for retornada pelo controle , chame o GetEmptyDesignTimeHtml() método , que se ele não for substituído para fornecer marcação específica, chamará o CreatePlaceHolderDesignTimeHtml() método , que deve conter informações sobre o tipo e a ID do controle.