ControlDesigner.GetDesignTimeHtml Metode

Definisi

Ruang nama:

System.Web.UI.Design

Rakitan:

System.Design.dll

Mengambil markup HTML yang digunakan untuk mewakili kontrol pada waktu desain.

Overload

GetDesignTimeHtml(DesignerRegionCollection)	Mengambil markup HTML untuk menampilkan kontrol dan mengisi koleksi dengan wilayah perancang kontrol saat ini.
GetDesignTimeHtml()	Mengambil markup HTML yang digunakan untuk mewakili kontrol pada waktu desain.

GetDesignTimeHtml(DesignerRegionCollection)

Mengambil markup HTML untuk menampilkan kontrol dan mengisi koleksi dengan wilayah perancang kontrol saat ini.

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

Parameter

regions

DesignerRegionCollection

Kumpulan wilayah perancang kontrol untuk kontrol terkait.

Mengembalikan

String

Markup HTML waktu desain untuk kontrol terkait, termasuk semua wilayah perancang kontrol.

Contoh

Contoh kode berikut menunjukkan cara membuat markup HTML menggunakan DesignerRegionCollection koleksi.

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

Keterangan

Host desain memanggil GetDesignTimeHtml metode untuk mendapatkan markup HTML waktu desain dan daftar wilayah perancang kontrol saat ini. Dengan menggunakan DesignerRegionCollection, host desain kemudian dapat meminta markup untuk setiap wilayah perancang kontrol yang dapat diedit.

Metode GetDesignTimeHtml ini disediakan untuk perancang kontrol turunan, seperti GridViewDesigner kelas , yang harus memproses konten untuk wilayah sebelum memanggil GetDesignTimeHtml metode .

Lihat juga

• GridViewDesigner
• Gambaran Umum ASP.NET Control Designers

GetDesignTimeHtml()

Mengambil markup HTML yang digunakan untuk mewakili kontrol pada waktu desain.

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

Mengembalikan

String

Markup HTML yang digunakan untuk mewakili kontrol pada waktu desain.

Contoh

Contoh kode berikut menunjukkan cara mengambil alih GetDesignTimeHtml metode dalam perancang kontrol kustom. Jika properti Teks untuk kontrol terkait kosong, GetDesignTimeHtml metode akan memanggil GetEmptyDesignTimeHtml metode . Jika tidak, GetDesignTimeHtml metode membuat dan merender kontrol 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

Catatan Bagi Inheritor

Jika Anda membuat kontrol kontainer kustom, pastikan Anda merender kontrol dan semua kontrol anak pada waktu desain, terlepas dari apakah Visible properti diatur ke true atau false.

Lihat juga

• GetEmptyDesignTimeHtml()
• GetErrorDesignTimeHtml(Exception)
• GetDesignTimeHtml(DesignerRegionCollection)
• Gambaran Umum ASP.NET Control Designers