TableCellCollection.Item Property
Gets a TableCell from the TableCellCollection at the specified index.
[C#] In C#, this property is the indexer for the TableCellCollection class.
[Visual Basic] Public Default ReadOnly Property Item( _ ByVal index As Integer _ ) As TableCell [C#] public TableCell this[ int index ] {get;} [C++] public: __property TableCell* get_Item( int index ); [JScript] returnValue = TableCellCollectionObject.Item(index); -or- returnValue = TableCellCollectionObject(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 TableCell to return.
Parameters [Visual Basic, C#, C++]
- index
- An ordinal index value that specifies the TableCell to return.
Property Value
A TableCell that represents an element in the TableCellCollection.
Remarks
Use this indexer to get an individual TableCell in the TableCellCollection at the specified index using simple array notation.
Example
[Visual Basic, C#] The following example demonstrates how to use the indexer to get a TableCell from a TableCellCollection. Note that in the example, the Cells property of the TableRow is an instance of the TableCellCollection class.
[Visual Basic] <%@ Page Language="VB" AutoEventWireup="True" %> <html> <head> <script runat="server"> Sub Page_Load(sender As Object, e As EventArgs) Dim numrows As Integer = 5 Dim numcells As Integer = 6 Dim counter As Integer = 1 Dim a_row As New ArrayList() Dim a_column As New ArrayList() ' Create a table. Dim j As Integer For j = 0 To numrows - 1 Dim r As New TableRow() Dim i As Integer For i = 0 To numcells - 1 Dim c As New TableCell() c.Text = counter.ToString() r.Cells.Add(c) counter += 1 Next i Table1.Rows.Add(r) Next j If Not IsPostBack Then ' Create a DropDownList for the number of columns. Dim l As Integer For l = 0 To numcells - 1 a_column.Add(l.ToString()) Next l ' Create a DropDownList for the number of rows. Dim k As Integer For k = 0 To numrows - 1 a_row.Add(k.ToString()) Next k List1.DataSource = a_column List2.DataSource = a_row List1.DataBind() List2.DataBind() End If End Sub Sub Button_Click(sender As Object, e As EventArgs) Dim column As Integer = List1.SelectedIndex Dim row As Integer = List2.SelectedIndex Label1.Text = "The cell (" & column.ToString() & ", " & _ row.ToString() & ") contains the value " & _ Table1.Rows(row).Cells(column).Text & "." End Sub </script> </head> <body> <h3>TableCellCollection Example</h3> <form runat=server> <asp:Table id="Table1" runat="server"/> <br><br> <center> Column: <asp:DropDownList id="List1" runat="server"/> Row: <asp:DropDownList id="List2" runat="server"/> <br><br> <asp:Button id="Button1" Text="Display Cell" OnClick="Button_Click" runat="server"/> <br><br> <asp:Label id="Label1" runat="server"/> </center> </form> </body> </html> [C#] <%@ Page Language="C#" AutoEventWireup="True" %> <html> <head> <script runat="server"> void Page_Load(Object sender, EventArgs e) { int numrows = 5; int numcells = 6; int counter = 1; ArrayList a_row = new ArrayList(); ArrayList a_column = new ArrayList(); // Create a table. for (int j=0; j<numrows; j++) { TableRow r = new TableRow(); for (int i=0; i<numcells; i++) { TableCell c = new TableCell(); c.Text=counter.ToString(); r.Cells.Add(c); counter++; } Table1.Rows.Add(r); } if (!IsPostBack) { // Create a DropDownList for the number of columns. for (int l=0; l<numcells; l++) { a_column.Add(l.ToString()); } // Create a DropDownList for the number of rows. for (int k=0; k<numrows; k++) { a_row.Add(k.ToString()); } List1.DataSource=a_column; List2.DataSource=a_row; List1.DataBind(); List2.DataBind(); } } void Button_Click(object sender, EventArgs e) { int column = List1.SelectedIndex; int row = List2.SelectedIndex; Label1.Text="The cell (" + column.ToString() + ", " + row.ToString() + ") contains the value " + Table1.Rows[row].Cells[column].Text + "."; } </script> </head> <body> <h3>TableCellCollection Example</h3> <form runat=server> <asp:Table id="Table1" runat="server"/> <br><br> <center> Column: <asp:DropDownList id="List1" runat="server"/> Row: <asp:DropDownList id="List2" runat="server"/> <br><br> <asp:Button id="Button1" Text="Display Cell" OnClick="Button_Click" runat="server"/> <br><br> <asp:Label id="Label1" runat="server"/> </center> </form> </body> </html>
[C++, JScript] No example is available for C++ or JScript. To view a Visual Basic or C# example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family
See Also
TableCellCollection Class | TableCellCollection Members | System.Web.UI.WebControls Namespace | TableCell | TableRow | Cells