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

戻り値

コントロール ビルダーがその内部テキストを取得する必要がある場合は true。 既定値は、false です。

次の例では、 メソッドが InDesigner 呼び出されたときに プロパティを NeedsTagInnerText 使用します。 コントロールにこのビルダーがアタッチされている場合、 は、 NeedsTagInnerText デザイナーを通じてデザイン時にコントロールにアクセスするかどうかを決定します。 は NeedsTagInnerText プロパティの値を InDesigner 返し、 メソッドが SetTagInnerText 呼び出されます。 プロパティが InDesignerfalse設定されている場合は、 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 ページ フレームワークによって呼び出され、コード内で直接呼び出されるものではありません。

適用対象