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

命名空间:System.Data.SqlClient

程序集:System.Data（在 system.data.dll 中）

语法：

C#

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，以保证返回精确的值。

示例：

C#

privatestaticvoid 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();

}

}

继承层次结构 ：

System.Object

System.MarshalByRefObject

System.Data.Common.DbDataReader

System.Data.SqlClient.SqlDataReader

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