ControlDesigner.GetDesignTimeHtml Yöntem

Tanım

Ad Alanı:

System.Web.UI.Design

Bütünleştirilmiş Kod:

System.Design.dll

Tasarım zamanında denetimi temsil etmek için kullanılan HTML işaretlemesini alır.

Aşırı Yüklemeler

GetDesignTimeHtml(DesignerRegionCollection)	Denetimi görüntülemek için HTML işaretlemesini alır ve koleksiyonu geçerli denetim tasarımcısı bölgeleriyle doldurur.
GetDesignTimeHtml()	Tasarım zamanında denetimi temsil etmek için kullanılan HTML işaretlemesini alır.

GetDesignTimeHtml(DesignerRegionCollection)

Denetimi görüntülemek için HTML işaretlemesini alır ve koleksiyonu geçerli denetim tasarımcısı bölgeleriyle doldurur.

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

Parametreler

regions

DesignerRegionCollection

İlişkili denetim için denetim tasarımcısı bölgeleri koleksiyonu.

Döndürülenler

String

Tüm denetim tasarımcısı bölgeleri de dahil olmak üzere ilişkili denetim için tasarım zamanı HTML işaretlemesi.

Örnekler

Aşağıdaki kod örneği, koleksiyonu kullanarak HTML işaretlemesinin DesignerRegionCollection nasıl oluşturulacağını gösterir.

// 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

Açıklamalar

Tasarım konağı, tasarım zamanı HTML işaretlemesini ve geçerli denetim tasarımcısı bölgelerinin listesini almak için yöntemini çağırır GetDesignTimeHtml . Tasarım konağı, DesignerRegionCollection'ı kullanarak düzenlenebilir her denetim tasarımcısı bölgesi için işaretleme isteğinde bulunabilir.

GetDesignTimeHtml yöntemi, yöntemi çağırmadan GetDesignTimeHtml önce bölge içeriğini işlemesi gereken sınıfı gibi GridViewDesigner türetilmiş bir denetim tasarımcısı için sağlanır.

Ayrıca bkz.

• GridViewDesigner
• ASP.NET Denetim Tasarımcılarına Genel Bakış

GetDesignTimeHtml()

Tasarım zamanında denetimi temsil etmek için kullanılan HTML işaretlemesini alır.

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

Döndürülenler

String

Denetimi tasarım zamanında temsil etmek için kullanılan HTML işaretlemesi.

Örnekler

Aşağıdaki kod örneği, özel denetim tasarımcısında yönteminin GetDesignTimeHtml nasıl geçersiz kılınduğunu gösterir. İlişkili denetimin Text özelliği boşsa, GetDesignTimeHtml yöntemi yöntemini çağırır GetEmptyDesignTimeHtml . Aksi takdirde yöntemi GetDesignTimeHtml bir Köprü denetimi oluşturur ve işler.

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

Devralanlara Notlar

Özel kapsayıcı denetimi oluşturuyorsanız, özelliğin veya falseolarak ayarlanıp ayarlanmadığına true bakılmaksızın denetimi ve tüm alt denetimleri tasarım zamanında işlendiğinden Visible emin olun.

Ayrıca bkz.

• GetEmptyDesignTimeHtml()
• GetErrorDesignTimeHtml(Exception)
• GetDesignTimeHtml(DesignerRegionCollection)
• ASP.NET Denetim Tasarımcılarına Genel Bakış