Freigeben über


DetailsViewRowCollection Klasse

Definition

Stellt eine Auflistung von DetailsViewRow-Objekten in einem DetailsView-Steuerelement dar.

public ref class DetailsViewRowCollection : System::Collections::ICollection
public class DetailsViewRowCollection : System.Collections.ICollection
type DetailsViewRowCollection = class
    interface ICollection
    interface IEnumerable
Public Class DetailsViewRowCollection
Implements ICollection
Vererbung
DetailsViewRowCollection
Implementiert

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Die -Objekte in der Rows Auflistung eines DetailsView Steuerelements durchlaufen DetailsViewRow werden. Der Wert jeder Zeile wird dann auf der Seite angezeigt.


<%@ 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>

<%@ page language="VB" %>

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

  Sub SubmitButton_Click(ByVal sender As Object, ByVal e As EventArgs)
 
    ' Use the Count property to determine whether the
    ' Rows collection contains any item.
    If ItemDetailsView.Rows.Count > 0 Then
    
      ' Iterate through the Rows collection and display
      ' the value of each field.
      MessageLabel.Text = "The row values are: <br/><br/>"
    
      Dim row As DetailsViewRow
    
      For Each 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/>"
    
      Next
    
    Else
      
      MessageLabel.Text = "No items."
    
    End If
    
  End Sub
  
</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>

Hinweise

Die DetailsViewRowCollection -Klasse wird verwendet, um eine Auflistung von DetailsViewRow -Objekten in einem DetailsView -Steuerelement zu speichern und zu verwalten. Jede Zeile in einem DetailsView Steuerelement wird durch ein DetailsViewRow -Objekt dargestellt. Das DetailsView -Steuerelement verwendet die DetailsViewRowCollection -Klasse für seine Rows -Eigenschaft.

Hinweis

Die Rows -Eigenschaft enthält nur die Datenzeilen. Um die Kopfzeile, Fußzeile obere Pagerzeile und unteren Pagerzeile zuzugreifen, verwenden die HeaderRow, FooterRow, TopPagerRow, und BottomPagerRow Eigenschaften bzw.

Die DetailsViewRowCollection -Klasse unterstützt mehrere Möglichkeiten für den Zugriff auf die Elemente in der Auflistung:

  • Verwenden Sie den Item[] Indexer, um ein DetailsViewRow Objekt direkt aus der Auflistung an einem bestimmten nullbasierten Index abzurufen.

  • Verwenden Sie die GetEnumerator -Methode, um einen Enumerator abzurufen, der zum Durchlaufen der Auflistung verwendet werden kann.

  • Verwenden Sie die CopyTo -Methode, um die Elemente in der Auflistung in ein Array zu kopieren, das dann für den Zugriff auf die Elemente in der Auflistung verwendet werden kann.

Verwenden Sie die -Eigenschaft, um die Count Gesamtanzahl der Elemente in der Auflistung zu bestimmen.

Konstruktoren

DetailsViewRowCollection(ArrayList)

Initialisiert eine neue Instanz der DetailsViewRowCollection-Klasse mit dem angegebenen ArrayList-Objekt.

Eigenschaften

Count

Ruft die Anzahl der Elemente im DetailsViewRowCollection-Objekt ab.

IsReadOnly

Ruft einen Wert ab, der angibt, ob die Zeilen im DetailsViewRowCollection-Objekt geändert werden können.

IsSynchronized

Ruft einen Wert ab, der angibt, ob das DetailsViewRowCollection-Objekt synchronisiert (threadsicher) ist.

Item[Int32]

Ruft das DetailsViewRow-Objekt am angegebenen Index aus der Auflistung ab.

SyncRoot

Ruft das Objekt ab, mit dem der Zugriff auf die Auflistung synchronisiert wird.

Methoden

CopyTo(DetailsViewRow[], Int32)

Kopiert alle Elemente aus diesem DetailsViewRowCollection-Objekt in das angegebene Array-Objekt, beginnend beim angegebenen Index im Array.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetEnumerator()

Gibt einen Enumerator zurück, der alle DetailsViewRow-Objekte im DetailsViewRowCollection-Objekt enthält.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

ICollection.CopyTo(Array, Int32)

Kopiert alle Elemente aus diesem DetailsViewRowCollection-Objekt in das angegebene Array-Objekt, beginnend beim angegebenen Index im Array.

Erweiterungsmethoden

Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ um

OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs

AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.

AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.

Gilt für:

Weitere Informationen