ControlDesigner.GetEmptyDesignTimeHtml Metode

Definisi

Ruang nama:

System.Web.UI.Design

Rakitan:

System.Design.dll

Mengambil markup HTML untuk mewakili kontrol server Web pada waktu desain yang tidak akan memiliki representasi visual pada durasi.

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

Mengembalikan

String

Markup HTML yang digunakan untuk mewakili kontrol pada waktu desain yang sebaliknya tidak akan memiliki representasi visual. Defaultnya adalah persegi panjang yang berisi jenis dan ID komponen.

Contoh

Contoh kode berikut menunjukkan cara mengambil alih GetDesignTimeHtml metode dalam perancang kontrol kustom. Text Jika properti untuk kontrol terkait kosong, GetDesignTimeHtml metode akan memanggil GetEmptyDesignTimeHtml metode . Jika tidak, GetDesignTimeHtml metode membuat dan merender Hyperlink kontrol.

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

Keterangan

Perilaku GetEmptyDesignTimeHtml default metode ini adalah mengembalikan string yang berisi nama komponen. Metode GetEmptyDesignTimeHtml harus dipanggil dalam implementasi GetDesignTimeHtml metode ketika tidak ada markup HTML waktu desain.

Lihat juga

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