SqlDataReader.Read 方法

定義

命名空間:
System.Data.SqlClient
組件:
System.Data.SqlClient.dll
組件:
System.Data.dll
來源:
System.Data.SqlClient.notsupported.cs

推進到 SqlDataReader 下一個紀錄。

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

傳回

Boolean

true 若行數較多;否則 false。

實作

Read()

例外狀況

SqlException

SQL Server 執行命令文字時回傳錯誤。

範例

以下範例可產生一個SqlConnection、一個SqlCommand、一個。SqlDataReader 範例會讀取資料，並寫入主控台視窗。 程式碼接著會關閉 SqlDataReader。 在 SqlConnection 程式碼區塊結束 using 時會自動關閉。

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

備註

預設 SqlDataReader 位置位於第一個記錄之前。 因此，您必須先打電話 Read 開始存取任何資料。

每個關聯SqlDataReader的同時只能開啟一個SqlConnection，任何嘗試開啟另一個的嘗試都會失敗，直到第一個關閉為止。 同樣地，當 正在使用時 SqlDataReader ，相關聯 SqlConnection 的 正在忙於服務，直到你呼叫 Close。

適用於

另請參閱