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 страниц во время синтаксического анализа и не предназначен для вызова непосредственно в коде.