OdbcDataReader OdbcDataReader OdbcDataReader OdbcDataReader Class

정의

데이터 소스에서 데이터 행의 앞으로만 이동 가능한 스트림을 읽는 방법을 제공합니다.Provides a way of reading a forward-only stream of data rows from a data source. 이 클래스는 상속될 수 없습니다.This class cannot be inherited.

public ref class OdbcDataReader sealed : System::Data::Common::DbDataReader
public sealed class OdbcDataReader : System.Data.Common.DbDataReader
type OdbcDataReader = class
    inherit DbDataReader
Public NotInheritable Class OdbcDataReader
Inherits DbDataReader
상속

예제

다음 예제는 OdbcConnection, OdbcCommand, 및 OdbcDataReader합니다.The following example creates an OdbcConnection, an OdbcCommand, and an OdbcDataReader. 이 예제에서는 콘솔에 작성 된 데이터를 읽습니다.The example reads through the data, writing it out to the console. 를 마지막 합니다 OdbcDataReader, 차례로 OdbcConnection합니다.Finally, the example closes the OdbcDataReader, and then the OdbcConnection.

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

설명

만들려면는 OdbcDataReader를 호출 해야 합니다는 ExecuteReader 메서드의 OdbcCommand 직접 생성자를 사용 하는 대신 개체입니다.To create an OdbcDataReader, you must call the ExecuteReader method of the OdbcCommand object, instead of directly using a constructor.

하는 동안 합니다 OdbcDataReader 사용 되는 연결 된 OdbcConnection 역할을 수행 합니다 OdbcDataReader에 없는 다른 작업을 수행할 수 있습니다는 OdbcConnection 닫지.While the OdbcDataReader is being used, the associated OdbcConnection is busy serving the OdbcDataReader, and no other operations can be performed on the OdbcConnection other than closing it. 이 될 때까지 경우는 Close 메서드는 OdbcDataReader 라고 합니다.This is the case until the Close method of the OdbcDataReader is called. 호출한 후 될 때까지 출력 매개 변수를 검색할 수 없습니다 예를 들어 Close합니다.For example, you cannot retrieve output parameters until after you call Close.

결과 데이터를 읽는 동안 다른 프로세스 또는 스레드 집합에 대 한 변경 내용을 사용자에 게 표시 될 수 있습니다는 OdbcDataReader합니다.Changes made to a result set by another process or thread while data is being read may be visible to the user of the OdbcDataReader. 그러나 정확한 동작은 드라이버와 시간에 따라 다릅니다.However, the precise behavior is both driver and timing dependent.

IsClosedRecordsAffected 후 호출할 수 있는 속성만 OdbcDataReader 닫혀 있습니다.IsClosed and RecordsAffected are the only properties that you can call after the OdbcDataReader is closed. 경우에 따라 호출 해야 합니다 Close 호출할 수 있으려면 RecordsAffected합니다.Sometimes, you must call Close before you can call RecordsAffected.

속성

Depth Depth Depth Depth

현재 행의 중첩 수준을 나타내는 값을 가져옵니다.Gets a value that indicates the depth of nesting for the current row.

FieldCount FieldCount FieldCount FieldCount

현재 행의 열 수를 가져옵니다.Gets the number of columns in the current row.

HasRows HasRows HasRows HasRows

OdbcDataReader에 하나 이상의 행이 있는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the OdbcDataReader contains one or more rows.

IsClosed IsClosed IsClosed IsClosed

OdbcDataReader가 닫혔는지 여부를 나타냅니다.Indicates whether the OdbcDataReader is closed.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

열 서수가 지정된 경우, 지정된 열의 값을 네이티브 형식으로 가져옵니다.Gets the value of the specified column in its native format given the column ordinal.

Item[String] Item[String] Item[String] Item[String]

열 이름이 지정된 경우, 지정된 열의 값을 네이티브 형식으로 가져옵니다.Gets the value of the specified column in its native format given the column name.

RecordsAffected RecordsAffected RecordsAffected RecordsAffected

SQL 문을 실행하여 변경, 삽입 또는 삭제된 행 수를 가져옵니다.Gets the number of rows changed, inserted, or deleted by execution of the SQL statement.

메서드

Close() Close() Close() Close()

OdbcDataReader 개체를 닫습니다.Closes the OdbcDataReader object.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

가비지 수집에서 회수하기 전에 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다.Allows the object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetBoolean(Int32) GetBoolean(Int32) GetBoolean(Int32) GetBoolean(Int32)

지정된 열의 값에 해당하는 Boolean 값을 가져옵니다.Gets the value of the specified column as a Boolean.

GetByte(Int32) GetByte(Int32) GetByte(Int32) GetByte(Int32)

지정된 열의 값에 해당하는 바이트 값을 가져옵니다.Gets the value of the specified column as a byte.

GetBytes(Int32, Int64, Byte[], Int32, Int32) GetBytes(Int32, Int64, Byte[], Int32, Int32) GetBytes(Int32, Int64, Byte[], Int32, Int32) GetBytes(Int32, Int64, Byte[], Int32, Int32)

특정 버퍼 오프셋에서 시작하여 지정된 열 오프셋의 바이트 스트림을 버퍼에 배열로 읽어 들입니다.Reads a stream of bytes from the specified column offset into the buffer as an array, starting at the particular buffer offset.

GetChar(Int32) GetChar(Int32) GetChar(Int32) GetChar(Int32)

지정된 열의 값을 문자로 가져옵니다.Gets the value of the specified column as a character.

GetChars(Int32, Int64, Char[], Int32, Int32) GetChars(Int32, Int64, Char[], Int32, Int32) GetChars(Int32, Int64, Char[], Int32, Int32) GetChars(Int32, Int64, Char[], Int32, Int32)

특정 버퍼 오프셋에서 시작하여 지정된 열 오프셋의 문자 스트림을 버퍼에 배열로 읽어 들입니다.Reads a stream of characters from the specified column offset into the buffer as an array, starting at the particular buffer offset.

GetData(Int32) GetData(Int32) GetData(Int32) GetData(Int32)

지정된 열 서수에 대해 IDataReader를 반환합니다.Returns an IDataReader for the specified column ordinal.

GetDataTypeName(Int32) GetDataTypeName(Int32) GetDataTypeName(Int32) GetDataTypeName(Int32)

소스 데이터 형식의 이름을 가져옵니다.Gets the name of the source data type.

GetDate(Int32) GetDate(Int32) GetDate(Int32) GetDate(Int32)

지정된 열의 값에 해당하는 DateTime 개체를 가져옵니다.Gets the value of the specified column as a DateTime object.

GetDateTime(Int32) GetDateTime(Int32) GetDateTime(Int32) GetDateTime(Int32)

지정된 열의 값에 해당하는 DateTime 개체를 가져옵니다.Gets the value of the specified column as a DateTime object.

GetDecimal(Int32) GetDecimal(Int32) GetDecimal(Int32) GetDecimal(Int32)

지정된 열의 값에 해당하는 Decimal 개체를 가져옵니다.Gets the value of the specified column as a Decimal object.

GetDouble(Int32) GetDouble(Int32) GetDouble(Int32) GetDouble(Int32)

지정된 열의 값을 배정밀도 부동 소수점 숫자로 가져옵니다.Gets the value of the specified column as a double-precision floating-point number.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

데이터 판독기에서 행을 반복하는 데 사용할 수 있는 IEnumerator를 반환합니다.Returns an IEnumerator that can be used to iterate through the rows in the data reader.

GetFieldType(Int32) GetFieldType(Int32) GetFieldType(Int32) GetFieldType(Int32)

개체의 데이터 형식인 Type을 가져옵니다.Gets the Type that is the data type of the object.

GetFloat(Int32) GetFloat(Int32) GetFloat(Int32) GetFloat(Int32)

지정된 열의 값을 단정밀도 부동 소수점 숫자로 가져옵니다.Gets the value of the specified column as a single-precision floating-point number.

GetGuid(Int32) GetGuid(Int32) GetGuid(Int32) GetGuid(Int32)

지정된 열의 값을 GUID(Globally Unique Identifier)로 가져옵니다.Gets the value of the specified column as a globally unique identifier (GUID).

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetInt16(Int32) GetInt16(Int32) GetInt16(Int32) GetInt16(Int32)

지정된 열의 값을 16비트 부호 있는 정수로 가져옵니다.Gets the value of the specified column as a 16-bit signed integer.

GetInt32(Int32) GetInt32(Int32) GetInt32(Int32) GetInt32(Int32)

지정된 열의 값에 해당하는 32비트 부호 있는 정수를 가져옵니다.Gets the value of the specified column as a 32-bit signed integer.

GetInt64(Int32) GetInt64(Int32) GetInt64(Int32) GetInt64(Int32)

지정된 열의 값에 해당하는 64비트 부호 있는 정수를 가져옵니다.Gets the value of the specified column as a 64-bit signed integer.

GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetName(Int32) GetName(Int32) GetName(Int32) GetName(Int32)

지정된 열의 이름을 가져옵니다.Gets the name of the specified column.

GetOrdinal(String) GetOrdinal(String) GetOrdinal(String) GetOrdinal(String)

열 이름이 지정된 경우 열 서수를 가져옵니다.Gets the column ordinal, given the name of the column.

GetSchemaTable() GetSchemaTable() GetSchemaTable() GetSchemaTable()

DataTable의 열 메타데이터를 정의하는 OdbcDataReader을 반환합니다.Returns a DataTable that describes the column metadata of the OdbcDataReader.

GetString(Int32) GetString(Int32) GetString(Int32) GetString(Int32)

String으로 지정된 열 값을 가져옵니다.Gets the value of the specified column as a String.

GetTime(Int32) GetTime(Int32) GetTime(Int32) GetTime(Int32)

지정된 열의 값에 해당하는 TimeSpan 개체를 가져옵니다.Gets the value of the specified column as a TimeSpan object.

GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
GetValue(Int32) GetValue(Int32) GetValue(Int32) GetValue(Int32)

네이티브 형식에 있는 지정된 서수에서 열의 값을 가져옵니다.Gets the value of the column at the specified ordinal in its native format.

GetValues(Object[]) GetValues(Object[]) GetValues(Object[]) GetValues(Object[])

현재 행의 열 값으로 개체 배열을 채웁니다.Populates an array of objects with the column values of the current row.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
IsDBNull(Int32) IsDBNull(Int32) IsDBNull(Int32) IsDBNull(Int32)

열이 존재하지 않거나 없는 값을 포함하는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the column contains nonexistent or missing values.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
NextResult() NextResult() NextResult() NextResult()

SQL 배치 문의 결과를 읽는 동안 OdbcDataReader가 다음 결과를 읽도록 합니다.Advances the OdbcDataReader to the next result when reading the results of batch SQL statements.

Read() Read() Read() Read()

OdbcDataReader를 다음 레코드로 이동합니다.Advances the OdbcDataReader to the next record.

ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)

명시적 인터페이스 구현

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

OdbcDataReader 클래스의 현재 인스턴스에서 사용하는 모든 리소스를 해제합니다.Releases all resources used by the current instance of the OdbcDataReader class.

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

컬렉션을 반복하는 열거자를 반환합니다.Returns an enumerator that iterates through a collection.

적용 대상

추가 정보