ControlDesigner.GetDesignTimeHtml Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
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
Berlaku untuk
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
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