ControlParser.ParseControls(IDesignerHost, String) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
使用指定的設計工具主應用程式 (Designer Host),從指定的標記建立控制項陣列。
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 執行個體,其為頁面的設計工具主應用程式 (Designer Host)。
- controlText
- String
表示控制項之標記集合的字串。
傳回
Control[]
從 controlText
剖析而得的 Control 項目陣列,否則,如果剖析器無法建置控制項,則為 null
。
例外狀況
備註
方法 ParseControls 會使用設計工具主機的服務,存取代表 ASP.NET 網頁上註冊指示詞的字串。 設計工具主機服務是透過 ReferenceManager 物件的 屬性 RootDesigner 取得,如果無法使用,則 IWebFormReferenceManager 服務會取得。
如果剖析器無法從 controlText
參數建置控件,此方法ParseControls會擲回例外狀況。