ControlParser.ParseControl Methode

  • Referenz

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

Das folgende Codebeispiel zeigt, 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, der IWebFormReferenceManager Dienst abgerufen.

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

Weitere Informationen

Gilt für:

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

Das folgende Codebeispiel zeigt, 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, der IWebFormReferenceManager Dienst abgerufen.

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

Weitere Informationen

Gilt für: