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

戻り値

コントロール ビルダーがその内部テキストを取得する必要がある場合は truetrue if the control builder needs to get its inner text. 既定値は、false です。The default is false.

次の例ではInDesignerNeedsTagInnerTextメソッドが呼び出されたときにプロパティを使用します。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 InDesignerSetTagInnerTextプロパティの値を返してから、メソッドを呼び出します。The NeedsTagInnerText returns the value of the InDesigner property, and then the SetTagInnerText method is called. プロパティがInDesignerfalse設定されている場合は、がスローされます。ExceptionIf 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 page フレームワークによって呼び出され、コード内で直接呼び出すためのものではありません。This method is called by the ASP.NET page framework during parsing and is not intended to be called directly in you code.

適用対象