ControlDesigner.GetEmptyDesignTimeHtml Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.Design

Zestaw:: System.Design.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera znacznik HTML reprezentujący kontrolkę serwera sieci Web w czasie projektowania, która nie będzie miała wizualnej reprezentacji w czasie wykonywania.

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

Zwraca

String

Znacznik HTML używany do reprezentowania kontrolki w czasie projektowania, która w przeciwnym razie nie ma reprezentacji wizualnej. Wartość domyślna to prostokąt zawierający typ i identyfikator składnika.

Przykłady

W poniższym przykładzie kodu pokazano, jak zastąpić metodę GetDesignTimeHtml w niestandardowym projektancie kontrolek. Text Jeśli właściwość skojarzonej kontrolki jest pustaGetDesignTimeHtml, metoda wywołuje GetEmptyDesignTimeHtml metodę . GetDesignTimeHtml W przeciwnym razie metoda tworzy i renderuje kontrolkęHyperlink.

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

Uwagi

Domyślnym zachowaniem GetEmptyDesignTimeHtml metody jest zwrócenie ciągu zawierającego nazwę składnika. Metoda GetEmptyDesignTimeHtml powinna być wywoływana w implementacji GetDesignTimeHtml metody, gdy nie ma znaczników HTML w czasie projektowania.

Dotyczy

Produkt	Wersje
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Udostępnij za pośrednictwem