HtmlTableCellCollection.Item Property
Gets the HtmlTableCell at the specified index from the HtmlTableCellCollection.
[C#] In C#, this property is the indexer for the HtmlTableCellCollection class.
[Visual Basic] Public Default ReadOnly Property Item( _ ByVal index As Integer _ ) As HtmlTableCell [C#] public HtmlTableCell this[ int index ] {get;} [C++] public: __property HtmlTableCell* get_Item( int index ); [JScript] returnValue = HtmlTableCellCollectionObject.Item(index); -or- returnValue = HtmlTableCellCollectionObject(index);
[JScript] In JScript, you can use the default indexed properties defined by a type, but you cannot explicitly define your own. However, specifying the expando attribute on a class automatically provides a default indexed property whose type is Object and whose index type is String.
Arguments [JScript]
- index
- An ordinal index value that specifies the HtmlTableCell to return.
Parameters [Visual Basic, C#, C++]
- index
- An ordinal index value that specifies the HtmlTableCell to return.
Property Value
An HtmlTableCell that represents a cell contained in the HtmlTableCellCollection.
Remarks
Use this indexer to get an HtmlTableCell from the HtmlTableCellCollection. You can access an HtmlTableCell at a specified index by using simple array notation. For example, if you have an HtmlTableCellCollection called "MyCellCollection", you can access the first element in the collection by using the following statement:
[C#] HtmlTableCell MyCell = MyCellCollection[0]; [Visual Basic] Dim MyCell As HtmlTableCell = MyCellCollection(0)
Note The collection is zero-based; therefore, the first element in the collection contains an index value of 0.
Example
[Visual Basic, C#, JScript] The following example demonstrates how to use the indexer to retrieve a cell of a table, represented by an HtmlTableCell, from the HtmlTableCellCollection. The cell is then updated with new content. Notice that the Cells property of a row represented by an HtmlTableRow is the HtmlTableCellCollection.
[Visual Basic] <%@ Page Language="VB" AutoEventWireup="True" %> <html> <head> <script runat="server"> Sub Page_Load(sender As Object, e As EventArgs) Dim i As Integer Dim j As Integer Dim row As HtmlTableRow Dim cell As HtmlTableCell ' Get the number of rows and columns selected by the user. Dim numrows As Integer = CInt(Select1.Value) Dim numcells As Integer = CInt(Select2.Value) ' Iterate through the rows. For j = 0 to numrows - 1 ' Create a new row and add it to the Rows collection. row = New HtmlTableRow() ' Provide a different background color for alternating rows. If (j Mod 2) = 1 Then row.BgColor="Gainsboro" End If ' Iterate through the cells of a row. For i = 0 to numcells - 1 ' Create a new cell and add it to the Cells collection. cell = New HtmlTableCell() cell.Controls.Add(new LiteralControl("row " & _ j.ToString() & _ ", cell " & _ i.ToString())) row.Cells.Add(cell) Next i Table1.Rows.Add(row) Next j End Sub </script> </head> <body> <form runat="server"> <h3>HtmlTableCellCollection Example</h3> <table id="Table1" CellPadding="5" CellSpacing="0" Border="1" BorderColor="black" runat="server"/> <hr> Select the number of rows and columns to create: <br><br> Table rows: <select id="Select1" runat="server"> <option Value="1">1</option> <option Value="2">2</option> <option Value="3">3</option> <option Value="4">4</option> <option Value="5">5</option> </select> Table cells: <select id="Select2" runat="server"> <option Value="1">1</option> <option Value="2">2</option> <option Value="3">3</option> <option Value="4">4</option> <option Value="5">5</option> </select> <br><br> <input type="submit" value="Generate Table" runat="server"/> </form> </body> </html> [C#] <%@ Page Language="C#" AutoEventWireup="True" %> <html> <head> <script runat="server"> void Page_Load(Object sender, EventArgs e) { // Get the number of rows and columns selected by the user. int numrows = Convert.ToInt32(Select1.Value); int numcells = Convert.ToInt32(Select2.Value); // Iterate through the rows. for (int j=0; j<numrows; j++) { // Create a new row and add it to the Rows collection. HtmlTableRow row = new HtmlTableRow(); // Provide a different background color for alternating rows. if (j%2 == 1) row.BgColor="Gainsboro"; // Iterate through the cells of a row. for (int i=0; i<numcells; i++) { // Create a new cell and add it to the Cells collection. HtmlTableCell cell = new HtmlTableCell(); cell.Controls.Add(new LiteralControl("row " + j.ToString() + ", cell " + i.ToString())); row.Cells.Add(cell); } Table1.Rows.Add(row); } } </script> </head> <body> <form runat="server"> <h3>HtmlTableCellCollection Example</h3> <table id="Table1" CellPadding="5" CellSpacing="0" Border="1" BorderColor="black" runat="server"/> <hr> Select the number of rows and columns to create: <br><br> Table rows: <select id="Select1" runat="server"> <option Value="1">1</option> <option Value="2">2</option> <option Value="3">3</option> <option Value="4">4</option> <option Value="5">5</option> </select> Table cells: <select id="Select2" runat="server"> <option Value="1">1</option> <option Value="2">2</option> <option Value="3">3</option> <option Value="4">4</option> <option Value="5">5</option> </select> <br><br> <input type="submit" value="Generate Table" runat="server"/> </form> </body> </html> [JScript] <%@ Page Language="JScript" AutoEventWireup="True" %> <html> <head> <script runat="server"> function Page_Load(sender : Object, e : EventArgs) { // Get the number of rows and columns selected by the user. var numrows : int = Convert.ToInt32(Select1.Value); var numcells : int = Convert.ToInt32(Select2.Value); // Iterate through the rows. for (var j : int = 0; j < numrows; j++) { // Create a new row and add it to the Rows collection. var row : HtmlTableRow = new HtmlTableRow(); // Provide a different background color for alternating rows. if (j%2 == 1) row.BgColor="Gainsboro"; // Iterate through the cells of a row. for (var i : int = 0; i < numcells; i++) { // Create a new cell and add it to the Cells collection. var cell : HtmlTableCell = new HtmlTableCell(); cell.Controls.Add(new LiteralControl("row " + j.ToString() + ", cell " + i.ToString())); row.Cells.Add(cell); } Table1.Rows.Add(row); } } </script> </head> <body> <form runat="server"> <h3>HtmlTableCellCollection Example</h3> <table id="Table1" CellPadding="5" CellSpacing="0" Border="1" BorderColor="black" runat="server"/> <hr> Select the number of rows and columns to create: <br><br> Table rows: <select id="Select1" runat="server"> <option Value="1">1</option> <option Value="2">2</option> <option Value="3">3</option> <option Value="4">4</option> <option Value="5">5</option> </select> Table cells: <select id="Select2" runat="server"> <option Value="1">1</option> <option Value="2">2</option> <option Value="3">3</option> <option Value="4">4</option> <option Value="5">5</option> </select> <br><br> <input type="submit" value="Generate Table" runat="server"/> </form> </body> </html>
[C++] No example is available for C++. To view a Visual Basic, C#, or JScript example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family
See Also
HtmlTableCellCollection Class | HtmlTableCellCollection Members | System.Web.UI.HtmlControls Namespace | HtmlTableCell | HtmlTableRow | Cells