ControlDesigner.GetDesignTimeHtml Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает HTML-разметку, используемую для представления элемента управления во время разработки.
Перегрузки
GetDesignTimeHtml(DesignerRegionCollection) |
Получает разметку HTML для отображения элемента управления и заполняет коллекцию текущими областями конструктора элемента управления. |
GetDesignTimeHtml() |
Получает HTML-разметку, используемую для представления элемента управления во время разработки. |
GetDesignTimeHtml(DesignerRegionCollection)
Получает разметку HTML для отображения элемента управления и заполняет коллекцию текущими областями конструктора элемента управления.
public:
virtual System::String ^ GetDesignTimeHtml(System::Web::UI::Design::DesignerRegionCollection ^ regions);
public virtual string GetDesignTimeHtml (System.Web.UI.Design.DesignerRegionCollection regions);
abstract member GetDesignTimeHtml : System.Web.UI.Design.DesignerRegionCollection -> string
override this.GetDesignTimeHtml : System.Web.UI.Design.DesignerRegionCollection -> string
Public Overridable Function GetDesignTimeHtml (regions As DesignerRegionCollection) As String
Параметры
- regions
- DesignerRegionCollection
Коллекция областей конструктора элементов управления для связанного элемента управления.
Возвращаемое значение
Разметка HTML времени разработки для связанного элемента управления, включающая все области конструктора элементов управления.
Примеры
В следующем примере кода показано, как создать разметку HTML с помощью DesignerRegionCollection коллекции.
// Create the regions and design-time markup. Called by the designer host.
public override String GetDesignTimeHtml(DesignerRegionCollection regions) {
// Create 3 regions: 2 clickable headers and an editable row
regions.Add(new DesignerRegion(this, "Header0"));
regions.Add(new DesignerRegion(this, "Header1"));
// Create an editable region and add it to the regions
EditableDesignerRegion editableRegion =
new EditableDesignerRegion(this,
"Content" + myControl.CurrentView, false);
regions.Add(editableRegion);
// Set the highlight for the selected region
regions[myControl.CurrentView].Highlight = true;
// Use the base class to render the markup
return base.GetDesignTimeHtml();
}
' Create the regions and design-time markup. Called by the designer host.
Public Overrides Function GetDesignTimeHtml(ByVal regions As DesignerRegionCollection) As String
' Create 3 regions: 2 clickable headers and an editable row
regions.Add(New DesignerRegion(Me, "Header0"))
regions.Add(New DesignerRegion(Me, "Header1"))
' Create an editable region and add it to the regions
Dim editableRegion As EditableDesignerRegion = _
New EditableDesignerRegion(Me, _
"Content" & myControl.CurrentView, False)
regions.Add(editableRegion)
' Set the highlight for the selected region
regions(myControl.CurrentView).Highlight = True
' Use the base class to render the markup
Return MyBase.GetDesignTimeHtml()
End Function
Комментарии
Узел разработки GetDesignTimeHtml вызывает метод для получения разметки HTML во время разработки и текущего списка областей конструктора элементов управления. С помощью DesignerRegionCollection узел конструктора может запросить разметку для каждой редактируемой области конструктора элементов управления.
Этот GetDesignTimeHtml метод предоставляется для производного конструктора элементов управления, например GridViewDesigner класса, который должен обработать содержимое области перед вызовом GetDesignTimeHtml метода.
См. также раздел
Применяется к
GetDesignTimeHtml()
Получает HTML-разметку, используемую для представления элемента управления во время разработки.
public:
virtual System::String ^ GetDesignTimeHtml();
public virtual string GetDesignTimeHtml ();
abstract member GetDesignTimeHtml : unit -> string
override this.GetDesignTimeHtml : unit -> string
Public Overridable Function GetDesignTimeHtml () As 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
Примечания для тех, кто наследует этот метод
Если вы создаете пользовательский элемент управления контейнерами, убедитесь, что вы отрисовываете элемент управления и все дочерние элементы управления во время разработки независимо от того, задано true
ли Visible свойство или false
.
См. также раздел
- GetEmptyDesignTimeHtml()
- GetErrorDesignTimeHtml(Exception)
- GetDesignTimeHtml(DesignerRegionCollection)
- Обзор конструкторов элементов управления ASP.NET