コントロール ビルダがその内部テキストを取得するかどうかを決定します。内部テキストを取得する必要がある場合は、SetTagInnerText メソッドを呼び出す必要があります。このメソッドは ASP.NET ページ フレームワークによって呼び出されます。
名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文
'宣言
Public Overridable Function NeedsTagInnerText As Boolean
'使用
Dim instance As ControlBuilder
Dim returnValue As Boolean
returnValue = instance.NeedsTagInnerText
public virtual bool NeedsTagInnerText ()
public:
virtual bool NeedsTagInnerText ()
public boolean NeedsTagInnerText ()
public function NeedsTagInnerText () : boolean
適用できません。
戻り値
コントロール ビルダがその内部テキストを取得する必要がある場合は true。既定値は false です。
解説
内部テキストとは、コントロールの開始タグと終了タグの間にあるテキストのことです。
このメソッドは、解析中に ASP.NET ページ フレームワークによって呼び出されるもので、コードから直接使用するためのものではありません。
使用例
NeedsTagInnerText メソッドが呼び出される時に InDesigner プロパティを使用する例を次に示します。コントロールにこのビルダがアタッチされている場合、NeedsTagInnerText は、そのコントロールへの現在のアクセスが、デザイナを通じた (デザイン時の) アクセスであるかどうかを確認します。NeedsTagInnerText メソッドを呼び出すと、InDesigner プロパティの値が返され、その後 SetTagInnerText メソッドが呼び出されます。InDesigner プロパティが false に設定されている場合は、Exception がスローされます。それ以外の場合は、SetTagInnerText の呼び出しにより、コントロールの内部テキストが返されます。
<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
[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;
}
}
プラットフォーム
Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition
Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。
バージョン情報
.NET Framework
サポート対象 : 3.0,2.0,1.1,1.0