Literal.CreateControlCollection 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
針對 Literal 控制項目前的執行個體，建立 EmptyControlCollection 物件。
protected:
override System::Web::UI::ControlCollection ^ CreateControlCollection();protected override System.Web.UI.ControlCollection CreateControlCollection ();override this.CreateControlCollection : unit -> System.Web.UI.ControlCollectionProtected Overrides Function CreateControlCollection () As ControlCollection傳回
ControlCollection 物件，包含目前伺服器控制項的子伺服器控制項。
範例
下列程式碼範例示範如何在自訂伺服器控制項中覆寫 CreateControlCollection 方法，以便一律傳 Literal 回 物件的 類別實例 EmptyControlCollection 。
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="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>Custom LiteralControl - CreateControlCollection - C# Example</title>
<script runat="server">
void Button1_Click(Object sender, EventArgs e)
{
Literal1.Text = "Welcome to ASP.NET!";
}
</script>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom LiteralControl - CreateControlCollection - C# Example</h3>
<aspSample:CustomLiteralCreateControlCollection id="Literal1"
runat="server" text="Literal Text" />
<br /><br />
<asp:Button id="Button1"
Text="Change"
OnClick="Button1_Click"
runat="server"/>
</form>
</body>
</html>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" AutoEventWireup="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>Custom LiteralControl - CreateControlCollection - VB.Net Example</title>
<script runat="server">
Sub Button1_Click(sender As Object, e As EventArgs)
Literal1.Text = "Welcome to ASP.NET!"
End Sub
</script>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom LiteralControl - CreateControlCollection - VB.Net Example</h3>
<aspSample:CustomLiteralCreateControlCollection id="Literal1"
runat="server" text="Literal Text" />
<br /><br />
<asp:Button id="Button1"
Text="Change"
OnClick="Button1_Click"
runat="server"/>
</form>
</body>
</html>
using System.Web;
using System.Security.Permissions;
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
public sealed class CustomLiteralCreateControlCollection : System.Web.UI.LiteralControl
{
protected override System.Web.UI.ControlCollection CreateControlCollection()
{
// Return a new EmptyControlCollection
return new System.Web.UI.EmptyControlCollection(this);
}
}
}
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class CustomLiteralCreateControlCollection
Inherits System.Web.UI.WebControls.Literal
Protected Overrides Function CreateControlCollection() As System.Web.UI.ControlCollection
' Return a new EmptyControlCollection
Return New System.Web.UI.EmptyControlCollection(Me)
End Function
End Class
