ControlBuilder.NeedsTagInnerText Metode

Definisi

Ruang nama:

System.Web.UI

Rakitan:

System.Web.dll

Menentukan apakah penyusun kontrol perlu mendapatkan teks dalamnya. Jika demikian, SetTagInnerText(String) metode harus dipanggil. Metode ini dipanggil oleh kerangka kerja halaman ASP.NET.

public:
 virtual bool NeedsTagInnerText();

public virtual bool NeedsTagInnerText();

abstract member NeedsTagInnerText : unit -> bool
override this.NeedsTagInnerText : unit -> bool

Public Overridable Function NeedsTagInnerText () As Boolean

Mengembalikan

Boolean

true jika penyusun kontrol perlu mendapatkan teks dalamnya. Defaultnya adalah false.

Contoh

Contoh berikut menggunakan InDesigner properti saat metode dipanggil NeedsTagInnerText . Ketika kontrol memiliki penyusun ini yang melekat padanya, NeedsTagInnerText menentukan apakah kontrol diakses pada waktu desain melalui perancang. mengembalikan NeedsTagInnerText nilai InDesigner properti, lalu metode dipanggil SetTagInnerText . InDesigner Jika properti diatur ke false, maka Exception akan dilemparkan. Jika tidak, teks dalam kontrol dikembalikan pada SetTagInnerText panggilan.

[AspNetHostingPermission(SecurityAction.Demand, 
    Level=AspNetHostingPermissionLevel.Minimal)]
public sealed class MyControlControlBuilder : ControlBuilder
{
    private string _innerText;

    public override bool NeedsTagInnerText()
    {
        return InDesigner;
    }

    public override void SetTagInnerText(string text)
    {
        if (!InDesigner)
            throw new Exception("The control is not in design mode.");
        else
            _innerText = text;
    }
}

<AspNetHostingPermission(SecurityAction.Demand, _
  Level:=AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class MyControlControlBuilder
  Inherits ControlBuilder
    
    Private _innerText As String
    
    Overrides Public Function NeedsTagInnerText() As Boolean
      Return InDesigner
    End Function
    
    Overrides Public Sub SetTagInnerText(ByVal text As String)        
       If InDesigner = False
         Throw New System.Exception("The control is not in design mode.")
       Else
         _innerText = text
       End If
    End Sub
    
End Class

Keterangan

Teks dalam adalah teks antara tag pembuka dan penutup kontrol.

Metode ini dipanggil oleh kerangka kerja halaman ASP.NET selama penguraian dan tidak dimaksudkan untuk dipanggil langsung dalam kode Anda.