SqlDataReader 类

SqlDataReader 类

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

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

 语法

Visual Basic（声明）

Public Class SqlDataReader
Inherits DbDataReader
Implements IDataReader, IDisposable, IDataRecord

Visual Basic（用法）

Dim instance As SqlDataReader

C#

public class SqlDataReader : DbDataReader, IDataReader, IDisposable, IDataRecord

C++

public ref class SqlDataReader : public DbDataReader, IDataReader, IDisposable, IDataRecord

J#

public class SqlDataReader extends DbDataReader implements IDataReader, IDisposable,
IDataRecord

JScript

public class SqlDataReader extends DbDataReader implements 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 代码块的结尾处自动关闭。

Visual Basic

复制代码

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()
Console.WriteLine(String.Format("{0}, {1}", _
reader(0), reader(1)))
End While
' Call Close when done reading.
reader.Close()
End Using
End Sub

C#

复制代码

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