ControlBuilder.NeedsTagInnerText メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コントロール ビルダーがその内部テキストを取得するかどうかを決定します。 内部テキストを取得する必要がある場合は、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 呼び出されます。 プロパティが InDesigner に false
設定されている場合は、 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 ページ フレームワークによって呼び出され、コード内で直接呼び出されるものではありません。
適用対象
.NET