TemplateControl.ParseControl 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将输入字符串分析为 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。
示例
下面的代码示例演示如何使用 方法创建 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
一个指定是否忽略分析程序筛选器的值。
返回
已分析的控件。
注解
参数 content
包含用户控件 (.ascx 文件) 的内容。 此字符串不能包含任何代码,因为 ParseControl 该方法永远不会导致编译。
参数 ignoreParserFilter
允许 PageParserFilter 忽略 类。
PageParserFilter ASP.NET 分析程序使用 类来确定在分析时是否允许在页面中使用某个项。