Literal.CreateControlCollection Methode

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Erstellt ein EmptyControlCollection Objekt für die aktuelle Instanz des Literal Steuerelements.

protected:
 override System::Web::UI::ControlCollection ^ CreateControlCollection();
protected override System.Web.UI.ControlCollection CreateControlCollection();
override this.CreateControlCollection : unit -> System.Web.UI.ControlCollection
Protected Overrides Function CreateControlCollection () As ControlCollection

Gibt zurück

ControlCollection

Ein ControlCollection Objekt, das die untergeordneten Serversteuerelemente des aktuellen Serversteuerelements enthält.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die CreateControlCollection Methode in einem benutzerdefinierten Serversteuerelement überschreibt, sodass immer eine Instanz der EmptyControlCollection Klasse für das Literal Objekt zurückgegeben wird.

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

Gilt für:

Weitere Informationen