ControlBuilder にコントロール タグの内部テキストを提供します。
名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文
'宣言
Public Overridable Sub SetTagInnerText ( _
text As String _
)
'使用
Dim instance As ControlBuilder
Dim text As String
instance.SetTagInnerText(text)
public virtual void SetTagInnerText (
string text
)
public:
virtual void SetTagInnerText (
String^ text
)
public void SetTagInnerText (
String text
)
public function SetTagInnerText (
text : String
)
適用できません。
パラメータ
- text
提供されるテキスト。
解説
このメソッドは、NeedsTagInnerText が以前に true を返した場合だけ呼び出されます。
使用例
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