ControlParser.ParseControl 方法

定義

命名空間:

System.Web.UI.Design

組件:

System.Design.dll

從指定的標記建立控制件。

多載

ParseControl(IDesignerHost, String)	使用指定的設計工具主機，從指定的標記建立控件。
ParseControl(IDesignerHost, String, String)	使用指定的設計工具主機和指示詞，從指定的標記建立控件。

ParseControl(IDesignerHost, String)

使用指定的設計工具主機，從指定的標記建立控件。

public:
 static System::Web::UI::Control ^ ParseControl(System::ComponentModel::Design::IDesignerHost ^ designerHost, System::String ^ controlText);

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

static member ParseControl : System.ComponentModel.Design.IDesignerHost * string -> System.Web.UI.Control

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

參數

designerHost

IDesignerHost

IDesignerHost 實例，該實例是頁面的設計工具主機。

controlText

String

控件的 HTML 標記。

傳回

Control

controlText 所代表的 Control;否則，如果剖析器無法建置控件，null。

例外狀況

ArgumentNullException

參數無效。

範例

下列程式代碼範例示範如何從 HTML 標記文字建立控件。 此程式代碼範例是提供給 ControlParser 類別之較大範例的一部分。

// Create a Web control from the persisted control String*.
System::Web::UI::Control^ ctrl = ControlParser::ParseControl( host, inputForm->tbox->Text->Trim() );

// Create a Web control from the HTML markup.
System.Web.UI.Control ctrl =
    ControlParser.ParseControl(host, inputForm.TBox.Text.Trim());

' Create a Web control from the persisted control string.
Dim ctrl As System.Web.UI.Control = ControlParser.ParseControl(host, inputForm.TxBox.Text.Trim())

備註

ParseControl 方法會使用設計工具主機的服務，存取代表 ASP.NET 網頁上緩存器指示詞的字串。 設計工具主機服務是透過 RootDesigner 物件的 ReferenceManager 屬性取得，如果無法使用，則 IWebFormReferenceManager 服務。

如果剖析器無法建置控件，則 ParseControl 方法會擲回例外狀況。

另請參閱

• 擴充 Design-Time 支援
• 如何：在設計模式中擴充控件的外觀和行為

ParseControl(IDesignerHost, String, String)

使用指定的設計工具主機和指示詞，從指定的標記建立控件。

public:
 static System::Web::UI::Control ^ ParseControl(System::ComponentModel::Design::IDesignerHost ^ designerHost, System::String ^ controlText, System::String ^ directives);

public static System.Web.UI.Control ParseControl (System.ComponentModel.Design.IDesignerHost designerHost, string controlText, string directives);

static member ParseControl : System.ComponentModel.Design.IDesignerHost * string * string -> System.Web.UI.Control

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

參數

designerHost

IDesignerHost

IDesignerHost 實例，該實例是頁面的設計工具主機。

controlText

String

控件之 HTML 標記的文字。

directives

String

要包含在控件程式代碼中的頁面指示詞。

傳回

Control

controlText 所代表的 Control。

例外狀況

ArgumentNullException

參數無效。

範例

下列程式代碼範例示範如何從 HTML 標記文字建立控件。 此程式代碼範例是提供給 ControlParser 類別之較大範例的一部分。

// Create a Web control from the persisted control String*.
System::Web::UI::Control^ ctrl = ControlParser::ParseControl( host, inputForm->tbox->Text->Trim() );

// Create a Web control from the HTML markup.
System.Web.UI.Control ctrl =
    ControlParser.ParseControl(host, inputForm.TBox.Text.Trim());

' Create a Web control from the persisted control string.
Dim ctrl As System.Web.UI.Control = ControlParser.ParseControl(host, inputForm.TxBox.Text.Trim())

備註

ParseControl 方法會使用設計工具主機的服務，存取代表 ASP.NET 網頁上緩存器指示詞的字串。 設計工具主機服務是透過 RootDesigner 物件的 ReferenceManager 屬性取得，如果無法使用，則 IWebFormReferenceManager 服務。

如果剖析器無法建置控件，則 ParseControl 方法會擲回例外狀況。

另請參閱

• 擴充 Design-Time 支援
• 如何：在設計模式中擴充控件的外觀和行為