ControlDesigner.GetEmptyDesignTimeHtml Metodo

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

Restituisce

Markup HTML usato per rappresentare un controllo in fase di progettazione che non avrebbe altrimenti una rappresentazione visiva. Il valore predefinito è un rettangolo che contiene il tipo e l'ID del componente.

Esempio

Nell'esempio di codice seguente viene illustrato come eseguire l'override del GetDesignTimeHtml metodo in una finestra di progettazione controlli personalizzata. Se la Text proprietà per il controllo associato è vuota, il metodo chiama GetEmptyDesignTimeHtml il GetDesignTimeHtml metodo . In caso contrario, il metodo crea ed esegue il GetDesignTimeHtml rendering di un Hyperlink controllo .

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

Commenti

Il comportamento predefinito del metodo consiste nel GetEmptyDesignTimeHtml restituire una stringa contenente il nome del componente. Il GetEmptyDesignTimeHtml metodo deve essere chiamato nell'implementazione del GetDesignTimeHtml metodo quando non è presente markup HTML in fase di progettazione.

Si applica a

Vedi anche

• GetErrorDesignTimeHtml(Exception)
• GetDesignTimeHtml
• Panoramica delle finestre di progettazione controlli di ASP.NET