ControlDesigner.GetEmptyDesignTimeHtml 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 para representar um controlo de servidor Web em tempo de design que não terá representação visual em tempo de execução.
protected:
virtual System::String ^ GetEmptyDesignTimeHtml();protected virtual string GetEmptyDesignTimeHtml();abstract member GetEmptyDesignTimeHtml : unit -> string
override this.GetEmptyDesignTimeHtml : unit -> stringProtected Overridable Function GetEmptyDesignTimeHtml () As StringDevoluções
A marcação HTML representava um controlo na altura do design que, de outra forma, não teria representação visual. O padrão é um retângulo que contém o tipo e o ID do componente.
Exemplos
O seguinte exemplo de código demonstra como sobrescrever o GetDesignTimeHtml método num designer de controlo personalizado. Se a Text propriedade do controlo associado for vazia, o GetDesignTimeHtml método chama GetEmptyDesignTimeHtml o método. Caso contrário, o GetDesignTimeHtml método cria e renderiza um Hyperlink controlo.
public override string GetDesignTimeHtml()
{
if (simpleControl.Text.Length > 0)
{
string spec = "<a href='{0}.aspx'>{0}</a>";
return String.Format(spec, simpleControl.Text);
}
else
{
return GetEmptyDesignTimeHtml();
}
}
Public Overrides Function GetDesignTimeHtml() As String
' Component is the instance of the component or control that
' this designer object is associated with. This property is
' inherited from System.ComponentModel.ComponentDesigner.
simpleControl = CType(Component, Simple)
If simpleControl.Text.Length > 0 Then
Dim sw As New StringWriter()
Dim tw As New HtmlTextWriter(sw)
Dim placeholderLink As New HyperLink()
' Put simpleControl.Text into the link's Text.
placeholderLink.Text = simpleControl.Text
placeholderLink.NavigateUrl = simpleControl.Text
placeholderLink.RenderControl(tw)
Return sw.ToString()
Else
Return GetEmptyDesignTimeHtml()
End If
End Function
Observações
O comportamento padrão do GetEmptyDesignTimeHtml método é devolver uma cadeia que contém o nome do componente. O GetEmptyDesignTimeHtml método deve ser chamado na implementação do GetDesignTimeHtml método quando não existe marcação HTML em tempo de design.
