OleDbDataReader 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
데이터 원본에서 데이터 행의 전달 전용 스트림을 읽는 방법을 제공합니다. 이 클래스는 상속할 수 없습니다.
public ref class OleDbDataReader sealed : System::Data::Common::DbDataReaderpublic ref class OleDbDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReaderpublic sealed class OleDbDataReader : System.Data.Common.DbDataReaderpublic sealed class OleDbDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReadertype OleDbDataReader = class
inherit DbDataReadertype OleDbDataReader = class
inherit MarshalByRefObject
interface IDataReader
interface IDisposable
interface IDataRecord
interface IEnumerablePublic NotInheritable Class OleDbDataReader
Inherits DbDataReaderPublic NotInheritable Class OleDbDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable- 상속
- 상속
- 구현
예제
다음 예제에서는 OleDbConnection, OleDbCommand및 OleDbDataReader만듭니다. 이 예제에서는 데이터를 읽고 콘솔에 기록합니다. 마지막으로, 이 예제에서는 OleDbDataReader 닫은 다음 OleDbConnection.
public static void ReadData(string connectionString, string queryString)
{
using (OleDbConnection connection = new OleDbConnection(connectionString))
{
OleDbCommand command = new OleDbCommand(queryString, connection);
connection.Open();
OleDbDataReader reader = command.ExecuteReader();
while (reader.Read())
{
Console.WriteLine(reader[0].ToString());
}
reader.Close();
}
}
Public Sub ReadData(ByVal connectionString As String, _
ByVal queryString As String)
Using connection As New OleDbConnection(connectionString)
Dim command As New OleDbCommand(queryString, connection)
connection.Open()
Dim reader As OleDbDataReader = command.ExecuteReader()
While reader.Read()
Console.WriteLine(reader(0).ToString())
End While
reader.Close()
End Using
End Sub
설명
OleDbDataReader만들려면 생성자를 직접 사용하는 대신 OleDbCommand 개체의 ExecuteReader 메서드를 호출해야 합니다.
OleDbConnection닫기 전에 먼저 OleDbDataReader 개체를 닫습니다. OleDbCommand 개체를 다시 사용하려는 경우에도 OleDbDataReader 개체를 닫아야 합니다. 예를 들어 Close호출할 때까지 출력 매개 변수를 검색할 수 없습니다.
데이터를 읽는 동안 다른 프로세스 또는 스레드가 설정한 결과 집합에 대한 변경 내용은 OleDbDataReader사용자에게 표시될 수 있습니다. 그러나 정확한 동작은 타이밍에 따라 달라집니다.
IsClosed 및 RecordsAffectedOleDbDataReader 닫은 후 호출할 수 있는 유일한 속성입니다. OleDbDataReader 있는 동안 RecordsAffected 속성에 액세스할 수 있지만 정확한 반환 값을 보장하기 위해 RecordsAffected 값을 반환하기 전에 항상 Close 호출합니다.
속성
| Depth |
현재 행의 중첩 깊이를 나타내는 값을 가져옵니다. |
| FieldCount |
현재 행의 열 수를 가져옵니다. |
| HasRows |
OleDbDataReader 하나 이상의 행이 포함되어 있는지 여부를 나타내는 값을 가져옵니다. |
| IsClosed |
데이터 판독기가 닫혀 있는지 여부를 나타냅니다. |
| Item[Int32] |
열 서수가 지정된 경우 지정된 열의 값을 네이티브 형식으로 가져옵니다. |
| Item[String] |
열 이름이 지정된 경우 지정된 열의 값을 네이티브 형식으로 가져옵니다. |
| RecordsAffected |
SQL 문을 실행하여 변경, 삽입 또는 삭제된 행 수를 가져옵니다. |
| VisibleFieldCount |
숨겨지지 않은 OleDbDataReader 필드 수를 가져옵니다. |
메서드
| Close() |
OleDbDataReader 개체를 닫습니다. |
| 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) |
요청된 열 서수에 대한 OleDbDataReader 개체를 반환합니다. |
| GetDataTypeName(Int32) |
원본 데이터 형식의 이름을 가져옵니다. |
| 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() |
OleDbDataReader열 메타데이터를 설명하는 DataTable 반환합니다. |
| GetSchemaTableAsync(CancellationToken) |
GetSchemaTable()비동기 버전입니다.
공급자는 적절한 구현으로 재정의해야 합니다.
|
| GetStream(Int32) |
지정된 열에서 데이터를 검색할 스트림을 가져옵니다. (다음에서 상속됨 DbDataReader) |
| GetString(Int32) |
지정된 열의 값을 문자열로 가져옵니다. |
| GetTextReader(Int32) |
열에서 데이터를 검색할 텍스트 판독기를 가져옵니다. (다음에서 상속됨 DbDataReader) |
| GetTimeSpan(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 문의 결과를 읽을 때 데이터 판독기를 다음 결과로 진행합니다. |
| NextResultAsync() |
문 일괄 처리 결과를 읽을 때 판독기를 다음 결과로 비동기적으로 진행합니다. (다음에서 상속됨 DbDataReader) |
| NextResultAsync(CancellationToken) |
문 일괄 처리 결과를 읽을 때 판독기를 다음 결과로 비동기적으로 진행합니다. (다음에서 상속됨 DbDataReader) |
| Read() |
OleDbDataReader 다음 레코드로 진행합니다. |
| ReadAsync() |
결과 집합의 다음 레코드로 판독기를 비동기적으로 진행합니다. (다음에서 상속됨 DbDataReader) |
| ReadAsync(CancellationToken) |
결과 집합의 다음 레코드로 판독기를 비동기적으로 진행합니다. (다음에서 상속됨 DbDataReader) |
| ToString() |
현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object) |
명시적 인터페이스 구현
| IDataRecord.GetData(Int32) |
지정된 열 서수에 대한 IDataReader 반환합니다. |
| IDataRecord.GetData(Int32) |
이 멤버에 대한 설명은 GetData(Int32)참조하세요. (다음에서 상속됨 DbDataReader) |
| IDisposable.Dispose() |
이 API는 제품 인프라를 지원하며 코드에서 직접 사용되지 않습니다. OleDbDataReader 클래스의 현재 인스턴스에서 사용하는 리소스를 해제합니다. |
| IEnumerable.GetEnumerator() |
컬렉션을 반복하는 열거자를 반환합니다. |
확장 메서드
적용 대상
추가 정보
- DataAdapters 및 DataReaders
.NET