ControlBuilder.NeedsTagInnerText 方法

定義

命名空間:

System.Web.UI

組件:

System.Web.dll

判斷控制項產生器是否需要取得它的內部文字。 如果是，必須呼叫 SetTagInnerText(String) 方法。 此方法由 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

傳回

Boolean

如果控制項產生器需要取得它的內部文字，則為 true。 預設為 false。

範例

下列範例會在 InDesigner 呼叫 方法時 NeedsTagInnerText 使用 屬性。 當控制項附加這個產生器時，會 NeedsTagInnerText 決定控制項是否在設計階段透過設計工具存取。 會 NeedsTagInnerText 傳回 屬性的值 InDesigner ，然後 SetTagInnerText 呼叫 方法。 InDesigner如果 屬性設定為 false ， Exception 則會擲回 。 否則，會在呼叫時 SetTagInnerText 傳回控制項的內部文字。

[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

備註

內部文字是控制項開頭和結束記號之間的文字。

這個方法是由剖析期間 ASP.NET 網頁架構所呼叫，不適合直接在您程式碼中呼叫。