OleDbDataReader 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
데이터 소스에서 데이터 행의 앞으로만 이동 가능한 스트림을 읽는 방법을 제공합니다. 이 클래스는 상속될 수 없습니다.
public ref class OleDbDataReader sealed : System::Data::Common::DbDataReader
public ref class OleDbDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public sealed class OleDbDataReader : System.Data.Common.DbDataReader
public sealed class OleDbDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
type OleDbDataReader = class
inherit DbDataReader
type OleDbDataReader = class
inherit MarshalByRefObject
interface IDataReader
interface IDisposable
interface IDataRecord
interface IEnumerable
Public NotInheritable Class OleDbDataReader
Inherits DbDataReader
Public NotInheritable Class OleDbDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
- 상속
- 상속
- 구현
예제
다음 예제에서는 , 및 를 OleDbCommandOleDbDataReader만듭니다OleDbConnection. 이 예제에서는 데이터를 읽고 콘솔에 기록합니다. 마지막으로 이 예제에서는 를 닫은 다음 을 닫습니다 OleDbDataReaderOleDbConnection.
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 닫습니다. 개체를 OleDbDataReader 다시 사용 OleDbCommand 하려는 경우에도 개체를 닫아야 합니다. 예를 들어 를 호출 Close할 때까지 출력 매개 변수를 검색할 수 없습니다.
데이터를 읽는 동안 다른 프로세스나 스레드에서 결과 집합을 변경한 내용은 OleDbDataReader의 사용자에게 표시될 수 있습니다. 그러나 정확한 동작은 타이밍에 따라 변합니다.
IsClosed가 닫힌 후 호출할 수 있는 속성은 RecordsAffected 및 OleDbDataReader뿐입니다. 가 있는 동안 속성에 RecordsAffected 액세스할 수 있지만 항상 값을 반환하기 전에 를 호출 Close 하여 RecordsAffected 정확한 반환 값을 보장 OleDbDataReader 합니다.
속성
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) |
지정된 열의 값에 해당하는 Boolean 값을 가져옵니다. |
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() |
DataTable의 열 메타데이터를 정의하는 OleDbDataReader을 반환합니다. |
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() |
컬렉션을 반복하는 열거자를 반환합니다. |
확장 메서드
적용 대상
추가 정보
.NET
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기