TemplateControl.ParseControl TemplateControl.ParseControl TemplateControl.ParseControl TemplateControl.ParseControl Method

Definition

Analysiert eine Eingabezeichenfolge für ein Control-Objekt auf einer ASP.NET-Webseite oder in einem Benutzersteuerelement.Parses an input string into a Control object on the ASP.NET Web page or user control.

Überlädt

ParseControl(String) ParseControl(String) ParseControl(String) ParseControl(String)

Analysiert eine Eingabezeichenfolge für ein Control-Objekt in einer Web Forms-Seite oder einem Benutzersteuerelement.Parses an input string into a Control object on the Web Forms page or user control.

ParseControl(String, Boolean) ParseControl(String, Boolean) ParseControl(String, Boolean) ParseControl(String, Boolean)

Analysiert eine Eingabezeichenfolge für ein Control-Objekt auf einer ASP.NET-Webseite oder in einem Benutzersteuerelement.Parses an input string into a Control object on the ASP.NET Web page or user control.

Hinweise

ParseControlwird in der .NET Framework Version 3,5 eingeführt.ParseControl is introduced in the .NET Framework version 3.5. Weitere Informationen finden Sie unter Versionen und Abhängigkeiten.For more information, see Versions and Dependencies.

ParseControl(String) ParseControl(String) ParseControl(String) ParseControl(String)

Analysiert eine Eingabezeichenfolge für ein Control-Objekt in einer Web Forms-Seite oder einem Benutzersteuerelement.Parses an input string into a Control object on the Web Forms page or user control.

public:
 System::Web::UI::Control ^ ParseControl(System::String ^ content);
public System.Web.UI.Control ParseControl (string content);
member this.ParseControl : string -> System.Web.UI.Control
Public Function ParseControl (content As String) As Control

Parameter

content
String String String String

Eine Zeichenfolge, die ein Benutzersteuerelement enthält.A string that contains a user control.

Gibt zurück

Das analysierte Control.The parsed Control.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Button Webserver Steuerelement mithilfe der ParseControl -Methode erstellt wird. Anschließend wird das Ergebnis ControlCollection der-Auflistung PlaceHolder eines Webserver Steuer Elements myPlaceholdernamens hinzugefügt.The following code example demonstrates how to create a Button Web server control using the ParseControl method, and then adds the result to the ControlCollection collection of a PlaceHolder Web server control named myPlaceholder.

<%@ Page language="c#" Debug="true" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ASP.NET Example</title>
<script runat="server">
    // System.Web.UI.TemplateControl.ParserControl;
    // The following example demonstrates the method 'ParseControl' of class TemplateControl.
    // Since TemplateControl is abstract, this sample has been written using 'Page' class which derives from 
    // 'TemplateControl' class.
    // A button object is created by passing a string to contstruct a button using ASP syntax, to the 
    // 'ParseControl' method. This button is added as one of the child controls of the page and displayed.
    void Page_Load(object sender, System.EventArgs e)
    {
      Control c = ParseControl("<asp:button text='Click here!' runat='server' />");
      myPlaceholder.Controls.Add(c);
    }
    </script>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:placeholder id ="myPlaceholder" runat="server" />
    </form>
  </body>
</html>
<%@ Page language="vb" Debug="true" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ASP.NET Example</title>
<script runat="server">
    '  System.Web.UI.TemplateControl.ParseControl;
    '  The following example demonstrates the method 'ParseControl' of class TemplateControl.
      
    ' Since TemplateControl is abstract, this sample has been written using 'Page' class which derives from 
    ' 'TemplateControl' class.
    ' A button object is created by passing a string to contstruct a button using ASP syntax, to the 
    ' 'ParseControl' method. This button is added as one of the child controls of the page and displayed.

    Sub Page_Load(sender As Object, e As System.EventArgs)
       Dim c As Control 
       c = ParseControl("<asp:button text='Click here!' runat='server' />")
       myPlaceholder.Controls.Add(c)
    End Sub 'Page_Load
    </script>
  </head>

  <body>
    <form id="form1" runat="server">
      <asp:placeholder id ="myPlaceholder" runat="server" />
    </form>
  </body>
</html>

Hinweise

Der content -Parameter enthält ein Benutzer Steuerelement, z. b. in einer ASCX-Datei.The content parameter contains a user control, such as you would find in an .ascx file. Diese Zeichenfolge darf keinen Code enthalten, da ParseControl die-Methode nie eine Kompilierung bewirkt.This string cannot contain any code, because the ParseControl method never causes compilation.

Siehe auch

ParseControl(String, Boolean) ParseControl(String, Boolean) ParseControl(String, Boolean) ParseControl(String, Boolean)

Analysiert eine Eingabezeichenfolge für ein Control-Objekt auf einer ASP.NET-Webseite oder in einem Benutzersteuerelement.Parses an input string into a Control object on the ASP.NET Web page or user control.

public:
 System::Web::UI::Control ^ ParseControl(System::String ^ content, bool ignoreParserFilter);
public System.Web.UI.Control ParseControl (string content, bool ignoreParserFilter);
member this.ParseControl : string * bool -> System.Web.UI.Control
Public Function ParseControl (content As String, ignoreParserFilter As Boolean) As Control

Parameter

content
String String String String

Eine Zeichenfolge, die ein Benutzersteuerelement enthält.A string that contains a user control.

ignoreParserFilter
Boolean Boolean Boolean Boolean

Ein Wert, der angibt, ob der Parserfilter ignoriert werden soll.A value that specifies whether to ignore the parser filter.

Gibt zurück

Das analysierte Steuerelement.The parsed control.

Hinweise

Der content -Parameter enthält ein Benutzer Steuerelement (den Inhalt einer ASCX-Datei).The content parameter contains a user control (the contents of an .ascx file). Diese Zeichenfolge darf keinen Code enthalten, da ParseControl die-Methode nie eine Kompilierung bewirkt.This string cannot contain any code, because the ParseControl method never causes compilation.

Der ignoreParserFilter -Parameter ermöglicht PageParserFilter das Ignorieren der-Klasse.The ignoreParserFilter parameter allows the PageParserFilter class to be ignored. Die PageParserFilter -Klasse wird vom ASP.NET-Parser verwendet, um zu bestimmen, ob ein Element zur Analysezeit auf der Seite zulässig ist.The PageParserFilter class is used by the ASP.NET parser to determine whether an item is allowed in the page at parse time.

Gilt für: