Literal.CreateControlCollection Metoda

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

EmptyControlCollection Vytvoří objekt pro aktuální instanci Literal ovládacího prvku.

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

Návraty

ControlCollection

Objekt ControlCollection , který bude obsahovat ovládací prvky podřízeného serveru aktuálního ovládacího prvku serveru.

Příklady

Následující příklad kódu ukazuje, jak přepsat metodu CreateControlCollection ve vlastním serverovém ovládacím prvku, aby vždy vrátil instanci EmptyControlCollection třídy objektu Literal .

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

Platí pro

Viz také

Přehled ovládacího prvku literálového webového serveru

Sdílet prostřednictvím