OdbcDataReader 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
데이터 소스에서 데이터 행의 앞으로만 이동 가능한 스트림을 읽는 방법을 제공합니다. 이 클래스는 상속될 수 없습니다.
public ref class OdbcDataReader sealed : System::Data::Common::DbDataReader
public ref class OdbcDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public sealed class OdbcDataReader : System.Data.Common.DbDataReader
public sealed class OdbcDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
type OdbcDataReader = class
inherit DbDataReader
type OdbcDataReader = class
inherit MarshalByRefObject
interface IDataReader
interface IDataRecord
interface IDisposable
interface IEnumerable
Public NotInheritable Class OdbcDataReader
Inherits DbDataReader
Public NotInheritable Class OdbcDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
- 상속
- 상속
- 구현
예제
다음 예제에서는 , 및 를 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) |
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) |
지정된 열 서수에 대해 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() |
DataTable의 열 메타데이터를 정의하는 OdbcDataReader을 반환합니다. |
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는 제품 인프라를 지원하며 코드에서 직접 사용되지 않습니다. 컬렉션을 반복하는 열거자를 반환합니다. |
확장 메서드
적용 대상
추가 정보
.NET
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기