TemplateControl.ParseControl-Methode

Artikel
08/20/2007

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

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Function ParseControl ( _
    content As String _
) As Control
'Usage
Dim instance As TemplateControl
Dim content As String
Dim returnValue As Control

returnValue = instance.ParseControl(content)

public Control ParseControl (
    string content
)

public:
Control^ ParseControl (
    String^ content
)

public Control ParseControl (
    String content
)

public function ParseControl (
    content : String
) : Control

Parameter

content
Eine Zeichenfolge, die ein Benutzersteuerelement enthält.

Rückgabewert

Das analysierte Control.

Hinweise

Der content-Parameter enthält ein Benutzersteuerelement, wie es in einer ASCX-Datei zu finden ist. Die Zeichenfolge darf keinen Code enthalten, da die ParseControl-Methode grundsätzlich keine Kompilierung veranlasst.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie ein Button-Webserversteuerelement mithilfe der ParseControl-Methode erstellt und das Ergebnis dann der ControlCollection-Auflistung des PlaceHolder-Webserversteuerelements myPlaceholder hinzugefügt wird.

<%@ Page language="vb" Debug="true" %>
<HTML>
  <HEAD>
    <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 runat=server>
      <asp:placeholder id = myPlaceholder runat=server />
    </form>
  </body>
</HTML>

<%@ Page language="c#" Debug="true" %>
<HTML>
  <HEAD>
    <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 runat=server>
      <asp:placeholder id = myPlaceholder runat=server />
    </form>
  </body>
</HTML>

void Page_Load(Object sender, System.EventArgs e)
{
    Control c = ParseControl("<asp:button text='Click here!'"
        + " runat='server' />");
    myPlaceholder.get_Controls().Add(c);
}//Page_Load

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

TemplateControl-Klasse
TemplateControl-Member
System.Web.UI-Namespace
LoadControl

Freigeben über