HtmlTable.HtmlTableRowControlCollection Class

 

Represents a collection of HtmlTableRow objects that are the rows of an HtmlTable control.

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

System.Object
  System.Web.UI.ControlCollection
    System.Web.UI.HtmlControls.HtmlTable.HtmlTableRowControlCollection

protected class HtmlTableRowControlCollection : ControlCollection

NameDescription
System_CAPS_pubpropertyCount

Gets the number of server controls in the ControlCollection object for the specified ASP.NET server control.(Inherited from ControlCollection.)

System_CAPS_pubpropertyIsReadOnly

Gets a value indicating whether the ControlCollection object is read-only.(Inherited from ControlCollection.)

System_CAPS_pubpropertyIsSynchronized

Gets a value indicating whether the ControlCollection object is synchronized.(Inherited from ControlCollection.)

System_CAPS_pubpropertyItem[Int32]

Gets a reference to the server control at the specified index location in the ControlCollection object.(Inherited from ControlCollection.)

System_CAPS_protpropertyOwner

Gets the ASP.NET server control to which the ControlCollection object belongs.(Inherited from ControlCollection.)

System_CAPS_pubpropertySyncRoot

Gets an object that can be used to synchronize access to the collection of controls.(Inherited from ControlCollection.)

NameDescription
System_CAPS_pubmethodAdd(Control)

Adds the specified Control object to the collection.(Overrides ControlCollection.Add(Control).)

System_CAPS_pubmethodAddAt(Int32, Control)

Adds the specified Control object to the collection. The new control is added to the array at the specified index location.(Overrides ControlCollection.AddAt(Int32, Control).)

System_CAPS_pubmethodClear()

Removes all controls from the current server control's ControlCollection object.(Inherited from ControlCollection.)

System_CAPS_pubmethodContains(Control)

Determines whether the specified server control is in the parent server control's ControlCollection object.(Inherited from ControlCollection.)

System_CAPS_pubmethodCopyTo(Array, Int32)

Copies the child controls stored in the ControlCollection object to an System.Array object, beginning at the specified index location in the System.Array.(Inherited from ControlCollection.)

System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetEnumerator()

Retrieves an enumerator that can iterate through the ControlCollection object.(Inherited from ControlCollection.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_pubmethodIndexOf(Control)

Retrieves the index of a specified Control object in the collection.(Inherited from ControlCollection.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodRemove(Control)

Removes the specified server control from the parent server control's ControlCollection object.(Inherited from ControlCollection.)

System_CAPS_pubmethodRemoveAt(Int32)

Removes a child control, at the specified index location, from the ControlCollection object.(Inherited from ControlCollection.)

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

NameDescription
System_CAPS_pubmethodAsParallel()

Overloaded. Enables parallelization of a query.(Defined by ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Overloaded. Converts an IEnumerable to an IQueryable.(Defined by Queryable.)

System_CAPS_pubmethodCast<TResult>()

Casts the elements of an IEnumerable to the specified type.(Defined by Enumerable.)

System_CAPS_pubmethodOfType<TResult>()

Filters the elements of an IEnumerable based on a specified type.(Defined by Enumerable.)

The HtmlTable.HtmlTableRowControlCollection class represents a collection of HtmlTableRow objects for an HtmlTable control. Controls can be added at the end of the collection with the Add method, or at a specified index location in the collection with the AddAt method. Only controls of type HtmlTableRow can be added to the HtmlTable.HtmlTableRowControlCollection collection.

The following code example demonstrates how to create a custom HtmlTable.HtmlTableRowControlCollection that overrides the Add method so that when rows are added to a table, they are always added at the beginning of the table's row collection.

<%@ 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 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> 
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);
         }

       }

    }

}

.NET Framework
Available since 1.1

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: