ControlBuilder.NeedsTagInnerText 메서드

정의

컨트롤 작성기의 내부 텍스트를 가져와야 할 경우를 결정 합니다.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

반환

Boolean

컨트롤 작성기가 내부 텍스트를 가져오면 true를 반환합니다.true if the control builder needs to get its inner text. 기본값은 false입니다.The default is false.

예제

다음 예제에서는 NeedsTagInnerText 메서드가 호출 될 때 InDesigner 속성을 사용 합니다.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. NeedsTagInnerTextInDesigner 속성의 값을 반환한 다음 SetTagInnerText 메서드를 호출 합니다.The NeedsTagInnerText returns the value of the InDesigner property, and then the SetTagInnerText method is called. InDesigner 속성이 false로 설정 된 경우 Exception이 throw 됩니다.If 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.

적용 대상