ControlParser.ParseControls(IDesignerHost, String) メソッド

定義

名前空間:

System.Web.UI.Design

アセンブリ:

System.Design.dll

指定したデザイナー ホストを使用して、指定したマークアップからコントロールの配列を作成します。

public:
 static cli::array <System::Web::UI::Control ^> ^ ParseControls(System::ComponentModel::Design::IDesignerHost ^ designerHost, System::String ^ controlText);

public static System.Web.UI.Control[] ParseControls (System.ComponentModel.Design.IDesignerHost designerHost, string controlText);

static member ParseControls : System.ComponentModel.Design.IDesignerHost * string -> System.Web.UI.Control[]

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

パラメーター

designerHost

IDesignerHost

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

controlText

String

コントロールのマークアップのコレクションを表す文字列。

戻り値

Control[]

controlText から解析された、Control 要素の配列。パーサーがコントロールを作成できなかった場合は null。

例外

ArgumentNullException

designerHost が nullです。

- または -

controlText は null または空の文字列 ("") です。

注釈

メソッドは ParseControls 、デザイナー ホストのサービスを使用して、ASP.NET Web ページの register ディレクティブを表す文字列にアクセスします。 デザイナー ホスト サービスは、 オブジェクトの プロパティをReferenceManagerRootDesigner通じて取得されます。使用できない場合は、サービスがIWebFormReferenceManager取得されます。

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

こちらもご覧ください

• ParseControl
• Control
• デザイン時サポートの拡張
• 方法 : デザイン モードでコントロールの外観と動作を拡張する