SqlDataReader.Read Methode

Referenz

Definition

Namespace:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Assemblys:: netstandard.dll, System.Data.SqlClient.dll

Paket:: System.Data.SqlClient v4.8.6

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Setzt den SqlDataReader auf den nächsten Datensatz.

public:
 override bool Read();

public:
 virtual bool Read();

public override bool Read ();

public bool Read ();

override this.Read : unit -> bool

abstract member Read : unit -> bool
override this.Read : unit -> bool

Public Overrides Function Read () As Boolean

Public Function Read () As Boolean

Gibt zurück

Boolean

true, wenn weitere Zeilen vorhanden sind, andernfalls false.

Implementiert

Read()

Ausnahmen

SqlException

SQL Server hat beim Ausführen des Befehlstexts einen Fehler zurückgegeben.

Beispiele

Im folgenden Beispiel werden ein SqlConnection, ein SqlCommandund ein SqlDataReadererstellt. Im Beispiel werden die Daten gelesen und in das Konsolenfenster geschrieben. Der Code schließt dann die SqlDataReader. Wird SqlConnection automatisch am Ende des using Codeblocks geschlossen.

private static void ReadOrderData(string connectionString)
{
    string queryString =
        "SELECT OrderID, CustomerID FROM dbo.Orders;";

    using (SqlConnection connection =
               new SqlConnection(connectionString))
    {
        SqlCommand command =
            new SqlCommand(queryString, connection);
        connection.Open();

        SqlDataReader reader = command.ExecuteReader();

        // Call Read before accessing data.
        while (reader.Read())
        {
            ReadSingleRow((IDataRecord)reader);
        }

        // Call Close when done reading.
        reader.Close();
    }
}

private static void ReadSingleRow(IDataRecord dataRecord)
{
    Console.WriteLine(String.Format("{0}, {1}", dataRecord[0], dataRecord[1]));
}

Private Sub ReadOrderData(ByVal connectionString As String)
    Dim queryString As String = _
        "SELECT OrderID, CustomerID FROM dbo.Orders;"

    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        connection.Open()

        Dim reader As SqlDataReader = command.ExecuteReader()

        ' Call Read before accessing data.
        While reader.Read()
            ReadSingleRow(CType(reader, IDataRecord))
        End While

        ' Call Close when done reading.
        reader.Close()
    End Using
End Sub

Private Sub ReadSingleRow(ByVal record As IDataRecord)
   Console.WriteLine(String.Format("{0}, {1}", record(0), record(1)))
End Sub

Hinweise

Die Standardposition des der SqlDataReader steht vor dem ersten Datensatz. Daher müssen Sie aufrufen Read , um mit dem Zugriff auf daten zu beginnen.

Nur eine SqlDataReader pro zugeordnetem SqlConnection Element kann gleichzeitig geöffnet sein, und jeder Versuch, eine andere zu öffnen, schlägt fehl, bis die erste geschlossen ist. Auf ähnliche Weise ist der SqlDataReader zugeordnete SqlConnection während der Verwendung damit beschäftigt, es zu bedienen, bis Sie aufrufen Close.

Gilt für:

Freigeben über