DataTableReader.HasRows Eigenschaft

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Quelle:

DataTableReader.cs

Ruft einen Wert ab, der angibt, ob DataTableReader eine oder mehrere Zeilen enthält.

public:
 virtual property bool HasRows { bool get(); };

public override bool HasRows { get; }

member this.HasRows : bool

Public Overrides ReadOnly Property HasRows As Boolean

Eigenschaftswert

Boolean

true, wenn DataTableReader eine oder mehrere Zeilen enthält, andernfalls false.

Ausnahmen

InvalidOperationException

Es wurde versucht, Informationen über einen geschlossenen DataTableReader abzurufen.

Beispiele

Im folgenden Beispiel werden zwei DataTable Instanzen mit Daten gefüllt. Die erste DataTable enthält eine Zeile, und die zweite enthält keine Zeilen. Im Beispiel wird dann eine DataTableReader erstellt, die beide DataTable -Objekte enthält, und die PrintData-Methode aufgerufen, um den Inhalt der einzelnen Objekte anzuzeigen. Dabei wird der Wert der HasRows Jeweiligen -Eigenschaft überprüft, bevor printData aufgerufen wird.

private static void TestHasRows()
{
    DataTable customerTable = GetCustomers();
    DataTable productTable = GetProducts();

    using (DataTableReader reader = new DataTableReader(
               new DataTable[] { customerTable, productTable }))
    {
        do
        {
            if (reader.HasRows)
            {
                PrintData(reader);
            }
        } while (reader.NextResult());
    }

    Console.WriteLine("Press Enter to finish.");
    Console.ReadLine();
}

private static void PrintData(DataTableReader reader)
{
    // Loop through all the rows in the DataTableReader
    while (reader.Read())
    {
        for (int i = 0; i < reader.FieldCount; i++)
        {
            Console.Write(reader[i] + " ");
        }
        Console.WriteLine();
    }
}

private static DataTable GetCustomers()
{
    // Create sample Customers table, in order
    // to demonstrate the behavior of the DataTableReader.
    DataTable table = new DataTable();
    // Create two columns, ID and Name.
    DataColumn idColumn = table.Columns.Add("ID", typeof(int));
    table.Columns.Add("Name", typeof(string ));
    // Set the ID column as the primary key column.
    table.PrimaryKey = new DataColumn[] { idColumn };

    table.Rows.Add(new object[] { 1, "Mary" });
    return table;
}

private static DataTable GetProducts()
{
    // Create sample Products table, in order
    // to demonstrate the behavior of the DataTableReader.
    DataTable table = new DataTable();

    // Create two columns, ID and Name.
    DataColumn idColumn = table.Columns.Add("ID", typeof(int));
    table.Columns.Add("Name", typeof(string ));

    // Set the ID column as the primary key column.
    table.PrimaryKey = new DataColumn[] { idColumn };
    return table;
}

Private Sub TestHasRows()
   'Retrieve one row from the Store table:
   Dim customerTable As DataTable = GetCustomers()
   Dim productsTable As DataTable = GetProducts()

   Using reader As New DataTableReader( _
      New DataTable() {customerTable, productsTable})

      Do
         If reader.HasRows Then
            PrintData(reader)
         End If
      Loop While reader.NextResult()
   End Using

   Console.WriteLine("Press Enter to finish.")
   Console.ReadLine()
End Sub

Private Sub PrintData( _
   ByVal reader As DataTableReader)

   ' Loop through all the rows in the DataTableReader.
   Do While reader.Read()
      For i As Integer = 0 To reader.FieldCount - 1
         Console.Write("{0} ", reader(i))
      Next
      Console.WriteLine()
   Loop
End Sub
Private Function GetCustomers() As DataTable
   ' Create sample Customers table, in order
   ' to demonstrate the behavior of the DataTableReader.
   Dim table As New DataTable

   ' Create two columns, ID and Name.
   Dim idColumn As DataColumn = table.Columns.Add("ID", GetType(Integer))
   table.Columns.Add("Name", GetType(String))

   ' Set the ID column as the primary key column.
   table.PrimaryKey = New DataColumn() {idColumn}

   table.Rows.Add(New Object() {1, "Mary"})
   Return table
End Function

Private Function GetProducts() As DataTable
   ' Create sample Products table, in order
   ' to demonstrate the behavior of the DataTableReader.
   Dim table As New DataTable

   ' Create two columns, ID and Name.
   Dim idColumn As DataColumn = table.Columns.Add("ID", GetType(Integer))
   table.Columns.Add("Name", GetType(String))

   ' Set the ID column as the primary key column.
   table.PrimaryKey = New DataColumn() {idColumn}

   Return table
End Function

Hinweise

Die HasRows -Eigenschaft gibt Informationen zum aktuellen Resultset zurück. Wenn das DataTableReader mehrere Resultsets enthält, können Sie den Wert der HasRows -Eigenschaft unmittelbar nach dem Aufrufen der NextResult -Methode untersuchen, um zu ermitteln, ob das neue Resultset Zeilen enthält.

Verwenden Sie die HasRows -Eigenschaft, um die Anforderung zum Aufrufen der Read -Methode zu DataTableReader vermeiden, wenn keine Zeilen im aktuellen Resultset vorhanden sind.

Weitere Informationen

• NextResult()
• Read()