This documentation is archived and is not being maintained.

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 Language Filter 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

Show: