SqlDataReader 类

定义

public ref class SqlDataReader : System::Data::Common::DbDataReader, IDisposable

public ref class SqlDataReader : System::Data::Common::DbDataReader, IDisposable, System::Data::Common::IDbColumnSchemaGenerator

public ref class SqlDataReader : System::Data::Common::DbDataReader

public class SqlDataReader : System.Data.Common.DbDataReader, IDisposable

public class SqlDataReader : System.Data.Common.DbDataReader, IDisposable, System.Data.Common.IDbColumnSchemaGenerator

public class SqlDataReader : System.Data.Common.DbDataReader

type SqlDataReader = class
    inherit DbDataReader
    interface IDataReader
    interface IDisposable
    interface IDataRecord

type SqlDataReader = class
    inherit DbDataReader
    interface IDataReader
    interface IDataRecord
    interface IDisposable

type SqlDataReader = class
    inherit DbDataReader
    interface IDbColumnSchemaGenerator
    interface IDisposable

type SqlDataReader = class
    inherit DbDataReader
    interface IDbColumnSchemaGenerator
    interface IDataReader
    interface IDataRecord
    interface IDisposable

type SqlDataReader = class
    inherit DbDataReader
    interface IDisposable

Public Class SqlDataReader
Inherits DbDataReader
Implements IDisposable

Public Class SqlDataReader
Inherits DbDataReader
Implements IDbColumnSchemaGenerator, IDisposable

Public Class SqlDataReader
Inherits DbDataReader

继承

DbDataReader

SqlDataReader

实现

IDataReader IDataRecord IDisposable IDbColumnSchemaGenerator

示例

以下示例创建 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必须调用 ExecuteReader 对象的 方法 SqlCommand ，而不是直接使用构造函数。

SqlDataReader在使用 时，关联的 SqlConnection 正忙于为 提供服务SqlDataReader，除了关闭它，不能对 SqlConnection 其他执行其他操作。 在调用 的 SqlDataReader 方法之前Close就是这种情况。 例如，在调用 Close之前，无法检索输出参数。

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

IsClosed 和 RecordsAffected 是在关闭 SqlDataReader 后可以调用的唯一属性。 RecordsAffected尽管 可以在存在 时SqlDataReader访问 属性，但始终在返回 的值RecordsAffected之前调用 Close 以确保返回值的准确性。

使用顺序访问 (CommandBehavior.SequentialAccess) 时， InvalidOperationException 如果 SqlDataReader 位置是高级的，并且对上一列尝试另一个读取操作，则会引发 。