OdbcDataReader 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
데이터 원본에서 데이터 행의 전달 전용 스트림을 읽는 방법을 제공합니다. 이 클래스는 상속할 수 없습니다.
public ref class OdbcDataReader sealed : System::Data::Common::DbDataReaderpublic ref class OdbcDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReaderpublic sealed class OdbcDataReader : System.Data.Common.DbDataReaderpublic sealed class OdbcDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReadertype OdbcDataReader = class
inherit DbDataReadertype OdbcDataReader = class
inherit MarshalByRefObject
interface IDataReader
interface IDataRecord
interface IDisposable
interface IEnumerablePublic NotInheritable Class OdbcDataReader
Inherits DbDataReaderPublic NotInheritable Class OdbcDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable- 상속
- 상속
- 구현
예제
다음 예제에서는 OdbcConnection, OdbcCommand및 OdbcDataReader만듭니다. 이 예제에서는 데이터를 읽고 콘솔에 기록합니다. 마지막으로 이 예제에서는 OdbcDataReader닫은 다음 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만들려면 생성자를 직접 사용하는 대신 OdbcCommand 개체의 ExecuteReader 메서드를 호출해야 합니다.
OdbcDataReader 사용하는 동안 연결된 OdbcConnectionOdbcDataReader처리 중이며 OdbcConnection 닫는 것 외에는 다른 작업을 수행할 수 없습니다. 이 경우는 OdbcDataReaderClose 메서드가 호출될 때까지입니다. 예를 들어 Close호출할 때까지 출력 매개 변수를 검색할 수 없습니다.
데이터를 읽는 동안 다른 프로세스 또는 스레드가 설정한 결과 집합에 대한 변경 내용은 OdbcDataReader사용자에게 표시될 수 있습니다. 그러나 정확한 동작은 드라이버와 타이밍에 따라 달라집니다.
IsClosed 및 RecordsAffectedOdbcDataReader 닫은 후 호출할 수 있는 유일한 속성입니다. RecordsAffected호출하려면 먼저 Close 호출해야 하는 경우가 있습니다.
속성
| Depth |
현재 행의 중첩 깊이를 나타내는 값을 가져옵니다. |
| FieldCount |
현재 행의 열 수를 가져옵니다. |
| HasRows |
OdbcDataReader 하나 이상의 행이 포함되어 있는지 여부를 나타내는 값을 가져옵니다. |
| IsClosed |
OdbcDataReader 닫혀 있는지 여부를 나타냅니다. |
| Item[Int32] |
열 서수가 지정된 경우 지정된 열의 값을 네이티브 형식으로 가져옵니다. |
| Item[String] |
열 이름이 지정된 경우 지정된 열의 값을 네이티브 형식으로 가져옵니다. |
| RecordsAffected |
SQL 문을 실행하여 변경, 삽입 또는 삭제된 행 수를 가져옵니다. |
| VisibleFieldCount |
숨겨지지 않은 DbDataReader 필드 수를 가져옵니다. (다음에서 상속됨 DbDataReader) |
메서드
| Close() |
OdbcDataReader 개체를 닫습니다. |
| CloseAsync() |
DbDataReader 개체를 비동기적으로 닫습니다. (다음에서 상속됨 DbDataReader) |
| CreateObjRef(Type) |
원격 개체와 통신하는 데 사용되는 프록시를 생성하는 데 필요한 모든 관련 정보를 포함하는 개체를 만듭니다. (다음에서 상속됨 MarshalByRefObject) |
| Dispose() |
DbDataReader 클래스의 현재 인스턴스에서 사용하는 모든 리소스를 해제합니다. (다음에서 상속됨 DbDataReader) |
| Dispose(Boolean) |
DbDataReader 사용하는 관리되지 않는 리소스를 해제하고 필요에 따라 관리되는 리소스를 해제합니다. (다음에서 상속됨 DbDataReader) |
| DisposeAsync() |
DbDataReader 클래스의 현재 인스턴스에서 사용하는 모든 리소스를 비동기적으로 해제합니다. (다음에서 상속됨 DbDataReader) |
| Equals(Object) |
지정된 개체가 현재 개체와 같은지 여부를 확인합니다. (다음에서 상속됨 Object) |
| Finalize() |
가비지 수집에서 회수되기 전에 개체가 리소스를 해제하고 다른 정리 작업을 수행할 수 있도록 합니다. |
| GetBoolean(Int32) |
지정된 열의 값을 부울로 가져옵니다. |
| GetByte(Int32) |
지정된 열의 값을 바이트로 가져옵니다. |
| GetBytes(Int32, Int64, Byte[], Int32, Int32) |
특정 버퍼 오프셋에서 시작하여 지정된 열 오프셋에서 버퍼로 바이트 스트림을 배열로 읽습니다. |
| GetChar(Int32) |
지정된 열의 값을 문자로 가져옵니다. |
| GetChars(Int32, Int64, Char[], Int32, Int32) |
특정 버퍼 오프셋에서 시작하여 지정된 열 오프셋에서 버퍼로 문자 스트림을 배열로 읽습니다. |
| GetColumnSchemaAsync(CancellationToken) |
GetColumnSchema(DbDataReader)비동기 버전입니다.
공급자는 적절한 구현으로 재정의해야 합니다.
|
| GetData(Int32) |
지정된 열 서수에 대한 IDataReader 반환합니다. |
| 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비트 부속 정수로 가져옵니다. |
| GetLifetimeService() |
사용되지 않음.
이 인스턴스의 수명 정책을 제어하는 현재 수명 서비스 개체를 검색합니다. (다음에서 상속됨 MarshalByRefObject) |
| GetName(Int32) |
지정된 열의 이름을 가져옵니다. |
| GetOrdinal(String) |
열 이름이 지정된 열 서수입니다. |
| GetProviderSpecificFieldType(Int32) |
지정된 열의 공급자별 형식을 가져옵니다. (다음에서 상속됨 DbDataReader) |
| GetProviderSpecificValue(Int32) |
지정된 열의 값을 공급자별 형식의 인스턴스로 가져옵니다. (다음에서 상속됨 DbDataReader) |
| GetProviderSpecificValues(Object[]) |
현재 행에 대한 컬렉션의 모든 공급자별 특성 열을 가져옵니다. (다음에서 상속됨 DbDataReader) |
| GetSchemaTable() |
OdbcDataReader열 메타데이터를 설명하는 DataTable 반환합니다. |
| GetSchemaTableAsync(CancellationToken) |
GetSchemaTable()비동기 버전입니다.
공급자는 적절한 구현으로 재정의해야 합니다.
|
| GetStream(Int32) |
지정된 열에서 데이터를 검색할 스트림을 가져옵니다. (다음에서 상속됨 DbDataReader) |
| GetString(Int32) |
지정된 열의 값을 String가져옵니다. |
| GetTextReader(Int32) |
열에서 데이터를 검색할 텍스트 판독기를 가져옵니다. (다음에서 상속됨 DbDataReader) |
| GetTime(Int32) |
지정된 열의 값을 TimeSpan 개체로 가져옵니다. |
| GetType() |
현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object) |
| GetValue(Int32) |
지정된 서수의 열 값을 네이티브 형식으로 가져옵니다. |
| GetValues(Object[]) |
개체 배열을 현재 행의 열 값으로 채웁니다. |
| InitializeLifetimeService() |
사용되지 않음.
이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다. (다음에서 상속됨 MarshalByRefObject) |
| IsDBNull(Int32) |
열에 존재하지 않는 값이나 누락된 값이 포함되어 있는지 여부를 나타내는 값을 가져옵니다. |
| IsDBNullAsync(Int32) |
열에 존재하지 않거나 누락된 값이 포함되어 있는지 여부를 나타내는 값을 비동기적으로 가져옵니다. (다음에서 상속됨 DbDataReader) |
| IsDBNullAsync(Int32, CancellationToken) |
열에 존재하지 않거나 누락된 값이 포함되어 있는지 여부를 나타내는 값을 비동기적으로 가져옵니다. (다음에서 상속됨 DbDataReader) |
| MemberwiseClone() |
현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object) |
| MemberwiseClone(Boolean) |
현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다. (다음에서 상속됨 MarshalByRefObject) |
| NextResult() |
일괄 처리 SQL 문의 결과를 읽을 때 OdbcDataReader 다음 결과로 진행합니다. |
| NextResultAsync() |
문 일괄 처리 결과를 읽을 때 판독기를 다음 결과로 비동기적으로 진행합니다. (다음에서 상속됨 DbDataReader) |
| NextResultAsync(CancellationToken) |
문 일괄 처리 결과를 읽을 때 판독기를 다음 결과로 비동기적으로 진행합니다. (다음에서 상속됨 DbDataReader) |
| Read() |
OdbcDataReader 다음 레코드로 진행합니다. |
| ReadAsync() |
결과 집합의 다음 레코드로 판독기를 비동기적으로 진행합니다. (다음에서 상속됨 DbDataReader) |
| ReadAsync(CancellationToken) |
결과 집합의 다음 레코드로 판독기를 비동기적으로 진행합니다. (다음에서 상속됨 DbDataReader) |
| ToString() |
현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object) |
명시적 인터페이스 구현
| IDataRecord.GetData(Int32) |
이 멤버에 대한 설명은 GetData(Int32)참조하세요. (다음에서 상속됨 DbDataReader) |
| IDisposable.Dispose() |
이 API는 제품 인프라를 지원하며 코드에서 직접 사용되지 않습니다. OdbcDataReader 클래스의 현재 인스턴스에서 사용하는 모든 리소스를 해제합니다. |
| IEnumerable.GetEnumerator() |
이 API는 제품 인프라를 지원하며 코드에서 직접 사용되지 않습니다. 컬렉션을 반복하는 열거자를 반환합니다. |
확장 메서드
적용 대상
추가 정보
- DataAdapters 및 DataReaders
.NET