Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

DetailsViewRowCollection, classe

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

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

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)
public class DetailsViewRowCollection : ICollection, 
	IEnumerable

Le type DetailsViewRowCollection expose les membres suivants.

  Nom Description
Méthode publique DetailsViewRowCollection Initialise une nouvelle instance de la classe DetailsViewRowCollection à l'aide de l'objet ArrayList spécifié.
Début
  Nom Description
Propriété publique Count Obtient le nombre d'éléments dans l'objet DetailsViewRowCollection.
Propriété publique IsReadOnly Obtient une valeur indiquant si les lignes de l'objet DetailsViewRowCollection peuvent être modifiées.
Propriété publique IsSynchronized Obtient une valeur indiquant si l'objet DetailsViewRowCollection est synchronisé (thread-safe).
Propriété publique Item Obtient l'objet DetailsViewRow de la collection à l'index spécifié.
Propriété publique SyncRoot Obtient l'objet utilisé pour synchroniser l'accès à la collection.
Début
  Nom Description
Méthode publique CopyTo Copie tous les éléments de l'objet DetailsViewRowCollection dans l'objet Array spécifié, en commençant à l'index spécifié dans Array.
Méthode publique Equals(Object) Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégée Finalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publique GetEnumerator Retourne un énumérateur qui contient tous les objets DetailsViewRow de l'objet DetailsViewRowCollection.
Méthode publique GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode publique ToString Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Début
  Nom Description
Méthode d'extension publique AsParallel Active la parallélisation d'une requête. (Défini par ParallelEnumerable.)
Méthode d'extension publique AsQueryable Convertit un IEnumerable en IQueryable. (Défini par Queryable.)
Méthode d'extension publique Cast<TResult> Convertit les éléments d'un IEnumerable vers le type spécifié. (Défini par Enumerable.)
Méthode d'extension publique OfType<TResult> Filtre les éléments d'un IEnumerable en fonction du type spécifié. (Défini par Enumerable.)
Début
  Nom Description
Implémentation d'interface explicite Méthode privée ICollection.CopyTo Infrastructure. Copie tous les éléments de l'objet DetailsViewRowCollection dans l'objet Array spécifié, en commençant à l'index spécifié dans Array.
Début

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.

Remarque Remarque

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 modes d'accès 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 itérer au sein de 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 itérer au sein des 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#" %>

<!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)
    {
      // 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 xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsViewRowCollection Example</title>
</head>
<body>
    <form id="form1" 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>


.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Cela vous a-t-il été utile ?
(1500 caractères restants)
Contenu de la communauté Ajouter
Annotations FAQ
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,