OdbcDataReader 类

提供从数据源读取数据行的只进流的方法。无法继承此类。

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

语法

声明
Public NotInheritable Class OdbcDataReader
    Inherits DbDataReader
用法
Dim instance As OdbcDataReader
public sealed class OdbcDataReader : DbDataReader
public ref class OdbcDataReader sealed : public DbDataReader
public final class OdbcDataReader extends DbDataReader
public final class OdbcDataReader extends DbDataReader

备注

若要创建 OdbcDataReader,必须调用 OdbcCommand 对象的 ExecuteReader 方法,而不能直接使用构造函数。

在使用 OdbcDataReader 时,关联的 OdbcConnection 正忙于为 OdbcDataReader 服务,对 OdbcConnection 无法执行任何其他操作,只能将它关闭。除非调用 OdbcDataReaderClose 方法,否则会一直处于此状态。例如,在调用 Close 之前,无法检索输出参数。

OdbcDataReader 的用户可能会看到在读取数据时另一进程或线程对结果集所做的更改。但是,精确的行为既取决于驱动程序又取决于执行时间。

OdbcDataReader 关闭后,只能调用 IsClosedRecordsAffected 属性。有时,必须先调用 Close,然后才能调用 RecordsAffected

示例

下面的示例创建一个 OdbcConnection、一个 OdbcCommand 和一个 OdbcDataReader。该示例读取全部数据,并将这些数据写到控制台。最后,该示例先关闭 OdbcDataReader,然后关闭 OdbcConnection

Public Sub ReadData(ByVal connectionString As String)
    Dim queryString As String = "SELECT DISTINCT CustomerID FROM Orders"

    Using connection As New OdbcConnection(connectionString)
        Dim command As New OdbcCommand(queryString, connection)

        connection.Open()

        Dim reader As OdbcDataReader = command.ExecuteReader()

        While reader.Read()
            Console.WriteLine("CustomerID={0}", reader(0).ToString)
        End While

        ' Call Close when done reading.
        reader.Close()
    End Using
End Sub
public static void ReadData(string connectionString)
{
    string queryString = "SELECT DISTINCT CustomerID FROM Orders";

    using (OdbcConnection connection = new OdbcConnection(connectionString))
    {
        OdbcCommand command = new OdbcCommand(queryString, connection);

        connection.Open();

        // Execute the DataReader and access the data.
        OdbcDataReader reader = command.ExecuteReader();
        while (reader.Read())
        {
            Console.WriteLine("CustomerID={0}", reader[0]);
        }

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

继承层次结构

System.Object
   System.MarshalByRefObject
     System.Data.Common.DbDataReader
      System.Data.Odbc.OdbcDataReader

线程安全

此类型的任何公共静态(Visual Basic 中的 Shared)成员都是线程安全的,但不保证所有实例成员都是线程安全的。

平台

Windows 98、Windows 2000 SP4、Windows Millennium Edition、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

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

版本信息

.NET Framework

受以下版本支持:2.0、1.1

请参见

参考

OdbcDataReader 成员
System.Data.Odbc 命名空间

其他资源

使用 DataReaders