dnnnet

导航

IDataReader 接口

IDataReader 接口

更新:2007 年 11 月

提供一种方法来读取一个或多个通过在数据源执行命令所获得的只进结果集流,这是由访问关系数据库的 .NET Framework 数据提供程序实现的。

命名空间:  System.Data
程序集:  System.Data(在 System.Data.dll 中)

语法


VB

C#

C++

F#

JScript

复制

'声明

 

Public Interface IDataReader _

       Implements IDisposable, IDataRecord

'用法

 

Dim instance As IDataReader

J#

复制

public interface IDataReader extends IDisposable,

       IDataRecord

备注


使用 IDataReader 和 IDataRecord 接口可以通过继承类实现 DataReader 类,该类提供一种读取结果集的一个或多个只进流的方法。有关 DataReader 类的更多信息,请参见使用 DataReader 检索数据 (ADO.NET)

应用程序不直接创建 IDataReader 接口的实例,而是创建继承 IDataReader 的类的实例。

继承 IDataReader 的类必须实现继承的成员,并通常会定义附加成员来添加提供程序特定的功能。

实现 IDataReader 的类的用户可以看到在读取数据的过程中其他进程或线程对结果集所做的更改。但是,精确的行为既取决于提供程序又取决于执行时间。

对实现者的说明:

为提高 .NET Framework 数据提供程序之间的一致性,请命名 Prv Command 窗体中的继承类,其中 Prv 是为特定 .NET Framework 数据提供程序命名空间中的所有类分配的统一前缀。例如,Sql 是 System.Data.SqlClient 命名空间中 SqlDataAdapter 类的前缀。

用户并不直接创建 DataReader 类的实例,而是通过使用 Command 对象的 ExecuteReader 方法获取 DataReader 实例。因此,您应该将 DataReader 构造函数标记为内部构造函数。

示例


下面的示例创建派生类 SqlConnectionSqlCommandSqlDataReader 的实例。该示例读取全部数据,并将这些数据写到控制台。最后,该示例先关闭 SqlDataReader,然后关闭 SqlConnection

VB

C#

C++

F#

JScript

复制

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

 

 

平台


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360

.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求

版本信息


.NET Framework

受以下版本支持:3.5、3.0、2.0、1.1、1.0

.NET Compact Framework

受以下版本支持:3.5、2.0、1.0

XNA Framework

受以下版本支持:1.0

另请参见

 

posted on 2010-05-24 20:30  sjgkkk  阅读(690)  评论(0编辑  收藏  举报