HtmlTable.HtmlTableRowControlCollection.Add-Methode

Artikel
08/20/2007

Fügt der Auflistung das angegebene Control-Objekt hinzu.

Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Overrides Sub Add ( _
    child As Control _
)
'Usage
Dim instance As HtmlTableRowControlCollection
Dim child As Control

instance.Add(child)

public override void Add (
    Control child
)

public:
virtual void Add (
    Control^ child
) override

public void Add (
    Control child
)

public override function Add (
    child : Control
)

Parameter

child
Das der Auflistung hinzuzufügende Control.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Das hinzugefügte Steuerelement muss vom Typ HtmlTableRow sein.

Hinweise

Das hinzugefügte Steuerelement darf nur ein HtmlTableRow-Steuerelement sein, andernfalls wird eine ArgumentException-Ausnahme ausgelöst.

Beispiel

Im folgenden Codebeispiel wird das Erstellen einer benutzerdefinierten HtmlTable.HtmlTableRowControlCollection-Auflistung veranschaulicht, die die Add-Methode überschreibt, sodass Zeilen, die zu einer Tabelle hinzugefügt werden, immer am Anfang der Zeilenauflistung der Tabelle eingefügt werden. Beachten Sie, wie die benutzerdefinierte Add-Methode die AddAt-Methode der Basisklasse mit dem index-Parameter 0 aufruft.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
  <head>
    <title>Custom HtmlTable - CustomHtmlTableRowControlCollection Example</title>
  </head>
  <body>
    <form id="Form1" 
          method="post" 
          runat="server">
      <h3>Custom HtmlTable - CustomHtmlTableRowControlCollection Example</h3>
      
      <aspSample:CustomHtmlTableRowControlCollection 
        id="HtmlTable1" 
        name="HtmlTable1" 
        runat="server" 
        border="1"
        cellSpacing="0" 
        cellPadding="5">
        <TR>
          <TD>1,1</TD>
          <TD>1,2</TD>
          <TD>1,3</TD>
        </TR>
        <TR>
          <TD>2,1</TD>
          <TD>2,2</TD>
          <TD>2,3</TD>
        </TR>
        <TR>
          <TD>3,1</TD>
          <TD>3,2</TD>
          <TD>3,3</TD>
        </TR>
      </aspSample:CustomHtmlTableRowControlCollection>

    </form>

  </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
  <head>
    <title>Custom HtmlTable - CustomHtmlTableRowControlCollection Example</title>
  </head>
  <body>
    <form id="Form1" 
          method="post" 
          runat="server">
      <h3>Custom HtmlTable - CustomHtmlTableRowControlCollection Example</h3>
      
      <aspSample:CustomHtmlTableRowControlCollection 
        id="HtmlTable1" 
        name="HtmlTable1" 
        runat="server" 
        border="1"
        cellSpacing="0" 
        cellPadding="5">
        <TR>
          <TD>1,1</TD>
          <TD>1,2</TD>
          <TD>1,3</TD>
        </TR>
        <TR>
          <TD>2,1</TD>
          <TD>2,2</TD>
          <TD>2,3</TD>
        </TR>
        <TR>
          <TD>3,1</TD>
          <TD>3,2</TD>
          <TD>3,3</TD>
        </TR>
      </aspSample:CustomHtmlTableRowControlCollection>

    </form>

  </body>
</html>

Imports System.Web
Imports System.Web.UI
Imports System.Security.Permissions

Namespace Samples.AspNet.VB.Controls
    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public NotInheritable Class CustomHtmlTableRowControlCollection
        Inherits System.Web.UI.HtmlControls.HtmlTable

        Protected Overrides Function CreateControlCollection() As System.Web.UI.ControlCollection

            Return New MyHtmlTableRowControlCollection(Me)

        End Function

        Protected Class MyHtmlTableRowControlCollection
            Inherits ControlCollection

            Friend Sub New(ByVal owner As Control)

                MyBase.New(owner)

            End Sub

            Public Overrides Sub Add(ByVal child As Control)

                ' Always add new rows at the top of the table.
                MyBase.AddAt(0, child)

            End Sub

        End Class

    End Class

End Namespace

using System.Web;
using System.Web.UI;
using System.Security.Permissions;

namespace Samples.AspNet.CS.Controls
{
    [AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
    public class CustomHtmlTableRowControlCollection : System.Web.UI.HtmlControls.HtmlTable
    {

       protected override ControlCollection CreateControlCollection()
       {

         return new MyHtmlTableRowControlCollection(this);

       }

       protected class MyHtmlTableRowControlCollection : ControlCollection
       {

         internal MyHtmlTableRowControlCollection(Control owner) : base(owner) { }

         public override void Add(Control child)
         {

           // Always add new rows at the top of the table.
           base.AddAt(0, child);
         }

       }

    }

}

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

HtmlTable.HtmlTableRowControlCollection-Klasse
HtmlTable.HtmlTableRowControlCollection-Member
System.Web.UI.HtmlControls-Namespace
AddAt

Freigeben über