DetailsViewRowCollection.Item Property

Note: This property is new in the .NET Framework version 2.0.

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; }
/** @property */
public DetailsViewRow get_Item (int index)

JScript supports the use of indexed properties, but not the declaration of new ones.

Parameters

index

The index of the DetailsViewRow to retrieve from the collection.

Property Value

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#" %>

<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>
  <body>
    <form 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>

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show: