ControlBuilder.NeedsTagInnerText Method


Determines if the control builder needs to get its inner text. If so, the SetTagInnerText(String) method must be called. This method is called by the ASP.NET page framework.

 virtual bool NeedsTagInnerText();
public virtual bool NeedsTagInnerText ();
abstract member NeedsTagInnerText : unit -> bool
override this.NeedsTagInnerText : unit -> bool
Public Overridable Function NeedsTagInnerText () As Boolean


true if the control builder needs to get its inner text. The default is false.


The following example uses the InDesigner property when the NeedsTagInnerText method is called. When a control has this builder attached to it, the NeedsTagInnerText determines whether the control is being accessed at design-time through a designer. The NeedsTagInnerText returns the value of the InDesigner property, and then the SetTagInnerText method is called. If the InDesigner property is set to false, an Exception is thrown. Otherwise, the inner text of the control is returned on the SetTagInnerText call.

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.");
            _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.")
         _innerText = text
       End If
    End Sub
End Class


The inner text is the text between the opening and closing tags of the control.

This method is called by the ASP.NET page framework during parsing and is not intended to be called directly in you code.

Applies to