Share via

ControlDesigner.GetEmptyDesignTimeHtml Método

  • Referência

Definição

Namespace:
System.Web.UI.Design
Assembly:
System.Design.dll

Recupera a marcação HTML para representar um controle de servidor Web em tempo de design que não terá uma 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 -> string
Protected Overridable Function GetEmptyDesignTimeHtml () As String

Retornos

String

A marcação HTML usada para representar um controle em tempo de design que, de outro modo, não teria uma representação visual. O padrão é um retângulo que contém o tipo e a ID do componente.

Exemplos

O exemplo de código a seguir demonstra como substituir o GetDesignTimeHtml método em um designer de controle personalizado. Se a Text propriedade do controle associado estiver vazia, o método chamará GetEmptyDesignTimeHtml o GetDesignTimeHtml método. Caso contrário, o GetDesignTimeHtml método cria e renderiza um Hyperlink controle.

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

Comentários

O comportamento padrão do GetEmptyDesignTimeHtml método é retornar uma cadeia de caracteres que contém o nome do componente. O GetEmptyDesignTimeHtml método deve ser chamado na implementação do GetDesignTimeHtml método quando não houver marcação HTML em tempo de design.

Aplica-se a

Confira também