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。

示例

以下示例在调用 方法时NeedsTagInnerText使用 InDesigner 属性。 当控件附加了此生成器时，将 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 页框架调用，不打算在代码中直接调用。