ControlParser.ParseControl Methode

Definition

Namespace:

System.Web.UI.Design

Assembly:

System.Design.dll

Erstellt ein Steuerelement aus dem angegebenen Markup.

Überlädt

ParseControl(IDesignerHost, String)	Erstellt mit dem angegebenen Designerhost ein Steuerelement aus dem angegebenen Markup.
ParseControl(IDesignerHost, String, String)	Erstellt mit dem angegebenen Designerhost und den angegebenen Direktiven ein Steuerelement aus dem angegebenen Markup.

ParseControl(IDesignerHost, String)

Erstellt mit dem angegebenen Designerhost ein Steuerelement aus dem angegebenen Markup.

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

Parameter

designerHost

IDesignerHost

Eine IDesignerHost-Instanz, die den Designerhost für die Seite darstellt.

controlText

String

Das HTML-Markup für das Steuerelement.

Gibt zurück

Control

Das Control, das controlText darstellt, andernfalls null, wenn der Parser das Steuerelement nicht erstellen kann.

Ausnahmen

ArgumentNullException

Ein Parameter ist nicht gültig.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie ein Steuerelement aus HTML-Markuptext erstellen. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ControlParser-Klasse bereitgestellt wird.

// 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())

Hinweise

Die ParseControl -Methode greift mithilfe der Dienste des Designerhosts auf die Zeichenfolge zu, die die Registerdirektiven auf der ASP.NET Webseite darstellt. Designerhostdienste werden über die ReferenceManager -Eigenschaft des RootDesigner -Objekts oder, falls diese nicht verfügbar ist, des IWebFormReferenceManager Diensts abgerufen.

Die ParseControl -Methode löst eine Ausnahme aus, wenn der Parser das Steuerelement nicht erstellen kann.

Weitere Informationen

• Erweitern der Entwurfszeitunterstützung
• Gewusst wie: Erweitern der Darstellung und des Verhaltens von Steuerelementen im Entwurfsmodus

ParseControl(IDesignerHost, String, String)

Erstellt mit dem angegebenen Designerhost und den angegebenen Direktiven ein Steuerelement aus dem angegebenen Markup.

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

Parameter

designerHost

IDesignerHost

Eine IDesignerHost-Instanz, die den Designerhost für die Seite darstellt.

controlText

String

Der Text des HTML-Markups für das Steuerelement.

directives

String

Die Seitendirektiven, die im Code für das Steuerelement enthalten sein sollen.

Gibt zurück

Control

Ein Control, das controlText darstellt.

Ausnahmen

ArgumentNullException

Ein Parameter ist nicht gültig.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie ein Steuerelement aus HTML-Markuptext erstellen. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ControlParser-Klasse bereitgestellt wird.

// 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())

Hinweise

Die ParseControl -Methode greift mithilfe der Dienste des Designerhosts auf die Zeichenfolge zu, die die Registerdirektiven auf der ASP.NET Webseite darstellt. Designerhostdienste werden über die ReferenceManager -Eigenschaft des RootDesigner -Objekts oder, falls diese nicht verfügbar ist, des IWebFormReferenceManager Diensts abgerufen.

Die ParseControl -Methode löst eine Ausnahme aus, wenn der Parser das Steuerelement nicht erstellen kann.

Weitere Informationen

• Erweitern der Entwurfszeitunterstützung
• Gewusst wie: Erweitern der Darstellung und des Verhaltens von Steuerelementen im Entwurfsmodus