다음을 통해 공유


ControlBuilder.NeedsTagInnerText 메서드

정의

컨트롤 작성기가 내부 텍스트를 가져오는지 결정합니다. 내부 텍스트를 가져오려면 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경우 throw 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 페이지 프레임워크에서 호출되며 코드에서 직접 호출되지 않습니다.

적용 대상