This documentation is archived and is not being maintained.

DetailsViewRowCollection.Item Property

Gets the DetailsViewRow object from the collection at the specified index.

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

public DetailsViewRow this[
	int index
] { get; }

Parameters

index
Type: System.Int32
The index of the DetailsViewRow to retrieve from the collection.

Property Value

Type: System.Web.UI.WebControls.DetailsViewRow
The DetailsViewRow at the specified index in the collection.

Use this indexer to retrieve a DetailsViewRow object from the collection at the specified index, using array notation.

The following code example demonstrates how to use the indexer to retrieve a DetailsViewRow object from the collection at a specific index.



<%@ page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void SubmitButton_Click(Object sender, EventArgs e)
  {

    // Use the Count property to determine whether the
    // Rows collection contains any item.
    if (ItemDetailsView.Rows.Count > 0)
    {
      // Display the field value in the first data row.

      // Use the indexer to get the first data row 
      // (index 0) from the Rows collection.
      DetailsViewRow row = ItemDetailsView.Rows[0];

      MessageLabel.Text = "The field value for the first row is: <br/><br/>";

      // Use the Text property to access the value of 
      // each cell. In this example, the cells in the 
      // first column (index 0) contains the field names, 
      // while the cells in the second column (index 1)
      // contains the field value. 
      MessageLabel.Text += row.Cells[0].Text + " = " +
        row.Cells[1].Text + "<br/>";
    }
    else
    {
      MessageLabel.Text = "No items.";
    }

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsViewRowCollection Indexer Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>DetailsViewRowCollection Indexer Example</h3>

      <asp:detailsview id="ItemDetailsView"
        datasourceid="DetailsViewSource"
        allowpaging="true"
        autogeneraterows="false" 
        runat="server">
        <fields>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
        </fields>
      </asp:detailsview>

      <br/>

      <asp:button id="SubmitButton" 
        text="Display Value"
        onclick="SubmitButton_Click"
        runat="server"/>

      <br/><br/>

      <asp:label id="MessageLabel"
        forecolor="Red"
        runat="server"/>

      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the web.config file.                            -->
      <asp:sqldatasource id="DetailsViewSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], 
          [City], [PostalCode], [Country] From [Customers]"
        connectionstring=
          "<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>  

    </form>
  </body>
</html>


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: