ControlParser.ParseControls メソッド

.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)

C#

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

C++

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

J#

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) または空の文字列 ("") です。

解説

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

controlText パラメータからパーサーがコントロールを作成できない場合、ParseControls メソッドは例外をスローします。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

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

参照

関連項目
ControlParser クラス
ControlParser メンバ
System.Web.UI.Design 名前空間
ParseControl
Control
その他の技術情報
デザイン時サポートの拡張
方法 : デザイン モードでコントロールの外観と動作を拡張する