SqlDataReader 类

提供一种从 SQL Server 数据库读取行的只进流的方式。无法继承此类。

命名空间:System.Data.SqlClient
程序集:System.Data（在 system.data.dll 中）

 

语法:

public class SqlDataReader : DbDataReader, IDataReader, IDisposable, IDataRecord

 

备注

---

若要创建 SqlDataReader，必须调用 SqlCommand 对象的 ExecuteReader 方法，
而不要直接使用构造函数。

在使用 SqlDataReader 时，关联的 SqlConnection 正忙于为 SqlDataReader 服务，
对 SqlConnection 无法执行任何其他操作，只能将其关闭。除非调用 SqlDataReader

的 Close 方法，否则会一直处于此状态。例如，在调用 Close 之前，无法检索输出参数。

SqlDataReader 的用户可能会看到在读取数据时另一进程或线程对结果集所做的
更改。但是，确切的行为与执行时间有关。

当 SqlDataReader 关闭后，只能调用 IsClosed 和 RecordsAffected 属性。尽管当
SqlDataReader 存在时可以访问 RecordsAffected 属性，但是请始终在返回

RecordsAffected 的值之前调用 Close，以保证返回精确的值。

注意

为了获得最佳性能，SqlDataReader 会避免创建不必要的对象或复制不必要的数据。
因此，对 GetValue 等方法的多次调用将返回对相同对象的引用。如果正在修改由

GetValue 等方法返回的对象的基础值，请使用警告。

示例

---

下面的示例创建一个 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())
        {
            Console.WriteLine(String.Format("{0}, {1}",
                reader[0], reader[1]));
        }

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