ControlParser.ParseControls メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

ControlParser.ParseControls メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定したデザイナホストを使用して、指定したコードの永続化文字列からコントロールの配列を作成します。

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

Visual Basic (宣言)

Public Shared Function ParseControls
 ( _
    designerHost As IDesignerHost, _
    controlText As String _
) As Control()

Visual Basic (使用法)

Dim designerHost As IDesignerHost
Dim controlText As String
Dim returnValue As Control()

returnValue = ControlParser.ParseControls(designerHost, controlText)

public static Control[] ParseControls (
    IDesignerHost designerHost,
    string controlText
)

C++

public:
static array<Control^>^ ParseControls (
    IDesignerHost^ designerHost, 
    String^ controlText
)

public static Control[] ParseControls (
    IDesignerHost designerHost, 
    String controlText
)

JScript

public static function ParseControls
 (
    designerHost : IDesignerHost, 
    controlText : String
) : Control[]

パラメータ

designerHost: ページのデザイナホストである IDesignerHost。

controlText: 永続化されたコントロールのコレクションを表す文字列。

戻り値
controlText から解析された、Control 要素の配列。パーサーがコントロールを作成できなかった場合は null 参照 (Visual Basic では Nothing)。

例外

例外の種類	条件
ArgumentNullException	designerHost が null 参照 (Visual Basic では Nothing) です。または controlText が null 参照 (Visual Basic では Nothing) または空の文字列 ("") です。

例外の種類

条件

ArgumentNullException

designerHost が null 参照 (Visual Basic では Nothing) です。

または

controlText が null 参照 (Visual Basic では Nothing) または空の文字列 ("") です。

解説

ParseControls メソッドは、デザイナホストのサービスを使用して、Web フォームページのレジスタディレクティブを表す文字列にアクセスします。デザイナホストサービスは、RootDesigner オブジェクトの ReferenceManager プロパティによって取得されます。取得できない場合は、IWebFormReferenceManager サービスが取得されます。