Cette documentation est archivée et n’est pas conservée.

DetailsViewRowCollection, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

Représente une collection d'objets DetailsViewRow dans un contrôle DetailsView.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public class DetailsViewRowCollection : ICollection, IEnumerable
public class DetailsViewRowCollection implements ICollection, IEnumerable
public class DetailsViewRowCollection implements ICollection, IEnumerable

La classe DetailsViewRowCollection est utilisée pour stocker et gérer une collection d'objets DetailsViewRow dans un contrôle DetailsView. Chaque ligne d'un contrôle DetailsView est représentée par un objet DetailsViewRow. Le contrôle DetailsView utilise la classe DetailsViewRowCollection pour sa propriété Rows.

RemarqueRemarque

La propriété Rows contient uniquement les lignes de données. Pour accéder à la ligne d'en-tête, à la ligne de pied de page, à la ligne supérieure du pagineur et à la ligne inférieure du pagineur, utilisez respectivement les propriétés HeaderRow, FooterRowTopPagerRow et BottomPagerRow.

La classe DetailsViewRowCollection prend en charge plusieurs manières d'accéder aux éléments de la collection :

  • Utilisez l'indexeur Item pour récupérer directement un objet DetailsViewRow de la collection à un index de base zéro spécifique.

  • Utilisez la méthode GetEnumerator afin de récupérer un énumérateur pouvant être utilisé pour parcourir la collection.

  • Utilisez la méthode CopyTo pour copier les éléments de la collection dans un tableau, qui peut ensuite être utilisé pour accéder aux éléments de la collection.

Utilisez la propriété Count pour déterminer le nombre total d'éléments de la collection.

L'exemple de code suivant montre comment parcourir les objets DetailsViewRow de la collection Rows d'un contrôle DetailsView. La valeur de chaque ligne est ensuite affichée dans la page.


<%@ 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)
    {
      // Iterate through the Rows collection and display
      // the value of each field.
      MessageLabel.Text = "The row values are: <br/><br/>";

      foreach (DetailsViewRow row in ItemDetailsView.Rows)
      {
        // 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 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 Row Values"
        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>

  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

System.Object
  System.Web.UI.WebControls.DetailsViewRowCollection

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Afficher: