ControlBuilder.NeedsTagInnerText ControlBuilder.NeedsTagInnerText ControlBuilder.NeedsTagInnerText ControlBuilder.NeedsTagInnerText Method

Определение

Определяет необходимость получения сборщиком элемента управления своего внутреннего текста.Determines if the control builder needs to get its inner text. В случае необходимости вызывается метод SetTagInnerText(String).If so, the SetTagInnerText(String) method must be called. Этот метод вызывается платформой страницы ASP.NET.This method is called by the ASP.NET page framework.

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

Возвраты

Значение true, если сборщик элемента управления получает свой внутренний текст.true if the control builder needs to get its inner text. Значение по умолчанию — false.The default is false.

Примеры

В следующем примере используется InDesigner свойство NeedsTagInnerText при вызове метода.The following example uses the InDesigner property when the NeedsTagInnerText method is called. Когда к элементу управления присоединен этот конструктор, NeedsTagInnerText определяет, осуществляется ли доступ к элементу управления во время разработки через конструктор.When a control has this builder attached to it, the NeedsTagInnerText determines whether the control is being accessed at design-time through a designer. NeedsTagInnerText Возвращает значение InDesigner свойстваSetTagInnerText , а затем вызывается метод.The NeedsTagInnerText returns the value of the InDesigner property, and then the SetTagInnerText method is called. Если свойство имеет falseзначение, Exception создается исключение. InDesignerIf the InDesigner property is set to false, an Exception is thrown. В противном случае в SetTagInnerText вызове возвращается внутренний текст элемента управления.Otherwise, the inner text of the control is returned on the SetTagInnerText call.

[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

Комментарии

Внутренний текст — это текст между открывающим и закрывающим тегами элемента управления.The inner text is the text between the opening and closing tags of the control.

Этот метод вызывается инфраструктурой страниц ASP.NET во время синтаксического анализа и не предназначен для непосредственного вызова в коде.This method is called by the ASP.NET page framework during parsing and is not intended to be called directly in you code.

Применяется к