TemplateControl.ParseControl 方法

  • 参考

定义

命名空间:
System.Web.UI
程序集:
System.Web.dll

将输入字符串分析为 ASP.NET 网页或用户控件上的 Control 对象。

重载

ParseControl(String)

将输入字符串分析为 Web 窗体页或用户控件上的 Control 对象。
ParseControl(String, Boolean)

将输入字符串分析为 ASP.NET 网页或用户控件上的 Control 对象。

注解

ParseControl在 .NET Framework 版本 3.5 中引入。 有关详细信息，请参见版本和依赖关系。

ParseControl(String)

将输入字符串分析为 Web 窗体页或用户控件上的 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

参数

content
String

包含用户控件的字符串。

返回

Control

已分析的 Control。

示例

下面的代码示例演示如何使用 方法创建 Button Web 服务器控件，然后将结果添加到ControlCollection名为 myPlaceholder的 Web 服务器控件的PlaceHolder集合ParseControl中。

<%@ 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>

注解

参数 content 包含用户控件，例如在 .ascx 文件中查找。 此字符串不能包含任何代码，因为 ParseControl 该方法永远不会导致编译。

另请参阅

适用于

ParseControl(String, Boolean)

将输入字符串分析为 ASP.NET 网页或用户控件上的 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

参数

content
String

包含用户控件的字符串。

ignoreParserFilter
Boolean

一个指定是否忽略分析程序筛选器的值。

返回

Control

已分析的控件。

注解

参数 content 包含用户控件 (.ascx 文件) 的内容。 此字符串不能包含任何代码，因为 ParseControl 该方法永远不会导致编译。

参数 ignoreParserFilter 允许 PageParserFilter 忽略 类。 PageParserFilter ASP.NET 分析程序使用 类来确定在分析时是否允许在页面中使用某个项。

适用于