ControlBuilder.NeedsTagInnerText メソッド

.NET Framework クラス ライブラリ リファレンス

ControlBuilder.NeedsTagInnerText メソッド

コントロール ビルダがその内部テキストを取得するかどうかを決定します。内部テキストを取得する必要がある場合は、SetTagInnerText メソッドを呼び出す必要があります。このメソッドは ASP.NET ページ フレームワークによって呼び出されます。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 NeedsTagInnerText As Boolean

Visual Basic (使用法)

Dim instance As ControlBuilder
Dim returnValue As Boolean

returnValue = instance.NeedsTagInnerText

C#

public virtual bool NeedsTagInnerText ()

C++

public:
virtual bool NeedsTagInnerText ()

J#

public boolean NeedsTagInnerText ()

JScript

public function NeedsTagInnerText () : boolean

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

解説

内部テキストとは、コントロールの開始タグと終了タグの間にあるテキストのことです。

このメソッドは、解析中に ASP.NET ページ フレームワークによって呼び出されるもので、コードから直接使用するためのものではありません。

使用例

NeedsTagInnerText メソッドが呼び出される時に InDesigner プロパティを使用する例を次に示します。コントロールにこのビルダがアタッチされている場合、NeedsTagInnerText は、そのコントロールへの現在のアクセスが、デザイナを通じた (デザイン時の) アクセスであるかどうかを確認します。NeedsTagInnerText メソッドを呼び出すと、InDesigner プロパティの値が返され、その後 SetTagInnerText メソッドが呼び出されます。InDesigner プロパティが false に設定されている場合は、Exception がスローされます。それ以外の場合は、SetTagInnerText の呼び出しにより、コントロールの内部テキストが返されます。

Visual Basic

<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

C#

[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 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ControlBuilder クラス
ControlBuilder メンバ
System.Web.UI 名前空間