ControlParser.ParseControls(IDesignerHost, String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
Ein Array von Control-Elementen, die durch Analysieren von controlText
erstellt wurden, andernfalls null
, wenn der Parser die Steuerelemente nicht erstellen kann.
Ausnahmen
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.