OdbcDataReader 클래스

정의

네임스페이스:

System.Data.Odbc

어셈블리:

System.Data.Odbc.dll

패키지:

System.Data.Odbc v8.0.0

Source:

OdbcDataReader.cs

데이터 소스에서 데이터 행의 앞으로만 이동 가능한 스트림을 읽는 방법을 제공합니다. 이 클래스는 상속될 수 없습니다.

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

상속

Object

DbDataReader

OdbcDataReader

예제

다음 예제에서는 , 및 를 OdbcCommandOdbcDataReader만듭니다OdbcConnection. 이 예제에서는 데이터를 읽고 콘솔에 기록합니다. 마지막으로, 예제는 를 닫은 다음 을 닫습니다OdbcDataReaderOdbcConnection.

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만들려면 생성자를 직접 사용하는 대신 개체의 OdbcCommand 메서드를 호출 ExecuteReader 해야 합니다.

을 OdbcDataReader 사용하는 동안 연결된 OdbcConnection 가 를 제공하는 OdbcDataReader데 사용 중이며 닫는 작업 외에는 OdbcConnection 다른 작업을 수행할 수 없습니다. 의 메서드 OdbcDataReader 가 Close 호출될 때까지의 경우입니다. 예를 들어 를 호출 Close할 때까지 출력 매개 변수를 검색할 수 없습니다.

데이터를 읽는 동안 다른 프로세스나 스레드에서 결과 집합을 변경한 내용은 OdbcDataReader의 사용자에게 표시될 수 있습니다. 그러나 정확한 동작은 드라이버와 타이밍에 따라 달라집니다.

IsClosed가 닫힌 후 호출할 수 있는 속성은 RecordsAffected 및 OdbcDataReader뿐입니다. 경우에 따라 를 호출하기 전에 를 호출 CloseRecordsAffected해야 합니다.

속성

Depth	현재 행의 중첩 수준을 나타내는 값을 가져옵니다.
FieldCount	현재 행의 열 수를 가져옵니다.
HasRows	OdbcDataReader에 하나 이상의 행이 있는지 여부를 나타내는 값을 가져옵니다.
IsClosed	OdbcDataReader가 닫혔는지 여부를 나타냅니다.
Item[Int32]	열 서수가 지정된 경우, 지정된 열의 값을 네이티브 형식으로 가져옵니다.
Item[String]	열 이름이 지정된 경우, 지정된 열의 값을 네이티브 형식으로 가져옵니다.
RecordsAffected	SQL 문을 실행하여 변경, 삽입 또는 삭제된 행 수를 가져옵니다.
VisibleFieldCount	표시되는 DbDataReader의 필드 수를 가져옵니다. (다음에서 상속됨 DbDataReader)

메서드

Close()	OdbcDataReader 개체를 닫습니다.
CloseAsync()	DbDataReader 개체를 비동기적으로 닫습니다. (다음에서 상속됨 DbDataReader)
Dispose()	DbDataReader 클래스의 현재 인스턴스에서 사용하는 모든 리소스를 해제합니다. (다음에서 상속됨 DbDataReader)
Dispose(Boolean)	DbDataReader에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다. (다음에서 상속됨 DbDataReader)
DisposeAsync()	DbDataReader 클래스의 현재 인스턴스에서 사용하는 모든 리소스를 비동기식으로 해제합니다. (다음에서 상속됨 DbDataReader)
Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
GetBoolean(Int32)	지정된 열의 값에 해당하는 Boolean 값을 가져옵니다.
GetByte(Int32)	지정된 열의 값에 해당하는 바이트 값을 가져옵니다.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	특정 버퍼 오프셋에서 시작하여 지정된 열 오프셋의 바이트 스트림을 버퍼에 배열로 읽어 들입니다.
GetChar(Int32)	지정된 열의 값을 문자로 가져옵니다.
GetChars(Int32, Int64, Char[], Int32, Int32)	특정 버퍼 오프셋에서 시작하여 지정된 열 오프셋의 문자 스트림을 버퍼에 배열로 읽어 들입니다.
GetColumnSchemaAsync(CancellationToken)	GetColumnSchema(DbDataReader)의 비동기 버전입니다. 공급자는 적절한 구현을 재정의해야 합니다. cancellationToken을 선택적으로 적용할 수 있습니다. 기본 구현은 동기 GetColumnSchema(DbDataReader) 호출을 호출하고 완료된 작업을 반환합니다. 기본 구현은 이미 취소된 cancellationToken을 전달하는 경우 취소된 작업을 반환합니다. GetColumnSchema(DbDataReader)에서 throw되는 예외는 반환된 Task Exception 속성을 통해 전달됩니다. (다음에서 상속됨 DbDataReader)
GetData(Int32)	요청된 열의 중첩된 데이터 판독기를 반환합니다. (다음에서 상속됨 DbDataReader)
GetDataTypeName(Int32)	소스 데이터 형식의 이름을 가져옵니다.
GetDate(Int32)	지정된 열의 값에 해당하는 DateTime 개체를 가져옵니다.
GetDateTime(Int32)	지정된 열의 값에 해당하는 DateTime 개체를 가져옵니다.
GetDbDataReader(Int32)	요청된 열 서수에 대한 DbDataReader 개체를 반환합니다. 이 개체는 공급자별 구현으로 재정의할 수 있습니다. (다음에서 상속됨 DbDataReader)
GetDecimal(Int32)	지정된 열의 값에 해당하는 Decimal 개체를 가져옵니다.
GetDouble(Int32)	지정된 열의 값을 배정밀도 부동 소수점 숫자로 가져옵니다.
GetEnumerator()	데이터 판독기의 행을 반복하는 데 사용할 수 있는 IEnumerator를 반환합니다.
GetFieldType(Int32)	개체의 데이터 형식인 Type을 가져옵니다.
GetFieldValue<T>(Int32)	지정된 열의 값을 요청된 형식으로 가져옵니다. (다음에서 상속됨 DbDataReader)
GetFieldValueAsync<T>(Int32)	지정된 열의 값을 요청된 형식으로 비동기적으로 가져옵니다. (다음에서 상속됨 DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)	지정된 열의 값을 요청된 형식으로 비동기적으로 가져옵니다. (다음에서 상속됨 DbDataReader)
GetFloat(Int32)	지정된 열의 값을 단정밀도 부동 소수점 숫자로 가져옵니다.
GetGuid(Int32)	지정한 열의 값을 GUID(Globally Unique Identifier)로 가져옵니다.
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetInt16(Int32)	지정된 열의 값을 16비트 부호 있는 정수로 가져옵니다.
GetInt32(Int32)	지정된 열의 값에 해당하는 32비트 부호 있는 정수를 가져옵니다.
GetInt64(Int32)	지정된 열의 값에 해당하는 64비트 부호 있는 정수를 가져옵니다.
GetName(Int32)	지정된 열의 이름을 가져옵니다.
GetOrdinal(String)	열 이름이 지정된 경우 열 서수를 가져옵니다.
GetProviderSpecificFieldType(Int32)	지정된 열의 공급자별 형식을 가져옵니다. (다음에서 상속됨 DbDataReader)
GetProviderSpecificValue(Int32)	지정된 열의 값을 공급자별 형식의 인스턴스로 가져옵니다. (다음에서 상속됨 DbDataReader)
GetProviderSpecificValues(Object[])	현재 행의 컬렉션에서 공급자별 특성 열을 모두 가져옵니다. (다음에서 상속됨 DbDataReader)
GetSchemaTable()	DataTable의 열 메타데이터를 정의하는 OdbcDataReader을 반환합니다.
GetSchemaTableAsync(CancellationToken)	GetSchemaTable()의 비동기 버전입니다. 공급자는 적절한 구현을 재정의해야 합니다. cancellationToken을 선택적으로 적용할 수 있습니다. 기본 구현은 동기 GetSchemaTable() 호출을 호출하고 완료된 작업을 반환합니다. 기본 구현은 이미 취소된 cancellationToken을 전달하는 경우 취소된 작업을 반환합니다. GetSchemaTable()에서 throw되는 예외는 반환된 Task Exception 속성을 통해 전달됩니다. (다음에서 상속됨 DbDataReader)
GetStream(Int32)	지정된 열에서 데이터를 검색하는 스트림을 가져옵니다. (다음에서 상속됨 DbDataReader)
GetString(Int32)	String으로 지정된 열 값을 가져옵니다.
GetTextReader(Int32)	열에서 데이터를 검색하는 텍스트 판독기를 가져옵니다. (다음에서 상속됨 DbDataReader)
GetTime(Int32)	지정된 열의 값에 해당하는 TimeSpan 개체를 가져옵니다.
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
GetValue(Int32)	네이티브 형식에 있는 지정된 서수에서 열의 값을 가져옵니다.
GetValues(Object[])	현재 행의 열 값으로 개체 배열을 채웁니다.
IsDBNull(Int32)	존재하지 않거나 누락된 값이 열에 포함되었는지 여부를 나타내는 값을 가져옵니다.
IsDBNullAsync(Int32)	열의 값이 존재하지 않거나 누락되었는지 여부를 나타내는 값을 비동기적으로 가져옵니다. (다음에서 상속됨 DbDataReader)
IsDBNullAsync(Int32, CancellationToken)	열의 값이 존재하지 않거나 누락되었는지 여부를 나타내는 값을 비동기적으로 가져옵니다. (다음에서 상속됨 DbDataReader)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
NextResult()	SQL 배치 문의 결과를 읽는 동안 OdbcDataReader가 다음 결과를 읽도록 합니다.
NextResultAsync()	일괄 문의 결과를 읽을 때 판독기를 다음 결과로 비동기로 이동합니다. (다음에서 상속됨 DbDataReader)
NextResultAsync(CancellationToken)	일괄 문의 결과를 읽을 때 판독기를 다음 결과로 비동기로 이동합니다. (다음에서 상속됨 DbDataReader)
Read()	OdbcDataReader를 다음 레코드로 이동합니다.
ReadAsync()	판독기를 결과 집합의 다음 레코드로 비동기로 이동합니다. (다음에서 상속됨 DbDataReader)
ReadAsync(CancellationToken)	판독기를 결과 집합의 다음 레코드로 비동기로 이동합니다. (다음에서 상속됨 DbDataReader)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

확장 메서드

추가 정보

• DataAdapters 및 DataReaders