ControlParser.ParseControls(IDesignerHost, String) Methode

Definition

Namespace:

System.Web.UI.Design

Assembly:

System.Design.dll

Erstellt mit dem angegebenen Designerhost ein Array der Steuerelemente aus dem angegebenen Markup.

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

Parameter

designerHost

IDesignerHost

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

controlText

String

Eine Zeichenfolge, die eine Auflistung von Markup für Steuerelemente darstellt.

Gibt zurück

Control[]

Ein Array von Control-Elementen, die durch Analysieren von controlText erstellt wurden, andernfalls null, wenn der Parser die Steuerelemente nicht erstellen kann.

Ausnahmen

ArgumentNullException

designerHost ist null.

- oder -

controlText ist null oder eine leere Zeichenfolge ("").

Hinweise

Die ParseControls -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 ParseControls -Methode löst eine Ausnahme aus, wenn der Parser die Steuerelemente nicht aus dem controlText Parameter erstellen kann.

Weitere Informationen

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