SqlDataReader.Read 方法

定义

命名空间:

Microsoft.Data.SqlClient

程序集:

Microsoft.Data.SqlClient.dll

包:

Microsoft.Data.SqlClient v5.2.0

让 SqlDataReader 前进到下一条记录。

public:
 override bool Read();

public override bool Read ();

override this.Read : unit -> bool

Public Overrides Function Read () As Boolean

返回

Boolean

如果存在更多行，则为 true；否则为 false。

实现

Read()

例外

SqlException

执行命令文本时，SQL Server 返回了一个错误。

示例

以下示例创建 SqlConnection、 SqlCommand、 和 SqlDataReader。 该示例通读数据，将其写入控制台窗口。 然后，代码关闭 SqlDataReader。 在 SqlConnection 代码块末尾 using 自动关闭 。

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        string str = "Data Source=(local);Initial Catalog=Northwind;"
            + "Integrated Security=SSPI";
        ReadOrderData(str);
    }

    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 record)
    {
        Console.WriteLine(String.Format("{0}, {1}", record[0], record[1]));
    }

}

注解

的默认位置 SqlDataReader 在第一条记录之前。 因此，必须调用 Read 才能开始访问任何数据。

每个关联的SqlConnection一次只能打开一SqlDataReader个，任何打开另一个的尝试都将失败，直到第一个尝试关闭。 同样，在使用 时 SqlDataReader ，关联的 SqlConnection 将忙于提供它，直到调用 Close。