Freigeben über


TemplateControl.ParseControl Methode

Definition

Analysiert eine Eingabezeichenfolge für ein Control-Objekt auf einer ASP.NET-Webseite oder in einem Benutzersteuerelement.

Überlädt

ParseControl(String)

Analysiert eine Eingabezeichenfolge für ein Control-Objekt in einer Web Forms-Seite oder einem Benutzersteuerelement.

ParseControl(String, Boolean)

Analysiert eine Eingabezeichenfolge für ein Control-Objekt auf einer ASP.NET-Webseite oder in einem Benutzersteuerelement.

Hinweise

ParseControlwird in der .NET Framework Version 3.5 eingeführt. Weitere Informationen finden Sie unter Versionen und Abhängigkeiten.

ParseControl(String)

Analysiert eine Eingabezeichenfolge für ein Control-Objekt in einer Web Forms-Seite oder einem Benutzersteuerelement.

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

Eine Zeichenfolge, die ein Benutzersteuerelement enthält.

Gibt zurück

Das analysierte Control.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der ParseControl -Methode ein Button Webserversteuerelement erstellen und das Ergebnis dann der ControlCollection Auflistung eines PlaceHolder Webserversteuerelements mit dem Namen myPlaceholderhinzufügen.

<%@ 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 Benutzersteuerelement, wie Sie es in einer ASCX-Datei finden würden. Diese Zeichenfolge kann keinen Code enthalten, da die ParseControl -Methode nie eine Kompilierung verursacht.

Weitere Informationen

Gilt für:

ParseControl(String, Boolean)

Analysiert eine Eingabezeichenfolge für ein Control-Objekt auf einer ASP.NET-Webseite oder in einem Benutzersteuerelement.

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

Eine Zeichenfolge, die ein Benutzersteuerelement enthält.

ignoreParserFilter
Boolean

Ein Wert, der angibt, ob der Parserfilter ignoriert werden soll.

Gibt zurück

Das analysierte Steuerelement.

Hinweise

Der content Parameter enthält ein Benutzersteuerelement (den Inhalt einer ASCX-Datei). Diese Zeichenfolge kann keinen Code enthalten, da die ParseControl -Methode nie eine Kompilierung verursacht.

Mit ignoreParserFilter dem Parameter kann die PageParserFilter -Klasse ignoriert werden. Die PageParserFilter -Klasse wird vom ASP.NET-Parser verwendet, um zu bestimmen, ob ein Element zur Analysezeit auf der Seite zulässig ist.

Gilt für: