Condividi tramite

ControlDesigner.GetEmptyDesignTimeHtml Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.Design
Assembly:
System.Design.dll

Recupera il markup HTML per rappresentare un controllo server Web in fase di progettazione che non avrà rappresentazione visiva in fase di esecuzione.

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

String

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