ControlDesigner.GetEmptyDesignTimeHtml Метод

Определение

Пространство имен:

System.Web.UI.Design

Сборка:

System.Design.dll

Извлекает разметку HTML, используемую для представления северного веб-элемента управления во время разработки, у которого не будет визуального представления во время выполнения.

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

Возвращаемое значение

String

Разметка HTML, используемая для представления элемента управления во время разработки, для которого нет другого способа получить визуальное представление. По умолчанию это прямоугольник, содержащий тип и идентификатор компонента.

Примеры

В следующем примере кода показано, как переопределить метод в конструкторе GetDesignTimeHtml пользовательских элементов управления. Text Если свойство для связанного элемента управления пусто, GetDesignTimeHtml метод вызывает GetEmptyDesignTimeHtml метод . GetDesignTimeHtml В противном случае метод создает и отрисовывает 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

Комментарии

По умолчанию GetEmptyDesignTimeHtml метод возвращает строку, содержащую имя компонента. Метод GetEmptyDesignTimeHtml должен вызываться в реализации метода при GetDesignTimeHtml отсутствии HTML-разметки во время разработки.

См. также раздел

• GetErrorDesignTimeHtml(Exception)
• GetDesignTimeHtml
• Общие сведения о конструкторах элементов управления ASP.NET