DataTableReader 클래스

정의

DataTableReader는 하나 이상의 DataTable 개체 내용을 하나 이상의 앞으로만 이동 가능한 읽기 전용 결과 집합 형태로 가져옵니다.The DataTableReader obtains the contents of one or more DataTable objects in the form of one or more read-only, forward-only result sets.

public ref class DataTableReader sealed : System::Data::Common::DbDataReader
public sealed class DataTableReader : System.Data.Common.DbDataReader
type DataTableReader = class
    inherit DbDataReader
Public NotInheritable Class DataTableReader
Inherits DbDataReader
상속

설명

DataTableReader 와 같은 다른 데이터 판독기와 비슷하게 작동 합니다 SqlDataReader점을 제외 하 고는 DataTableReader 행에 대해 반복을 제공를 DataTable.The DataTableReader works much like any other data reader, such as the SqlDataReader, except that the DataTableReader provides for iterating over rows in a DataTable. 즉, 캐시에 행을 반복 하기 위한 제공 합니다.In other words, it provides for iterating over rows in a cache. 캐시 된 데이터를 수정할 수 있습니다 하는 동안는 DataTableReader 가 활성 상태인 경우 판독기의 위치를 자동으로 유지 합니다.The cached data can be modified while the DataTableReader is active, and the reader automatically maintains its position.

만들 때를 DataTableReader 에서 DataTable, 결과 DataTableReader 개체와 동일한 데이터를 가진 하나의 결과 집합이 포함 되어 있습니다.는 DataTable 에서 생성 된, 삭제 된 것으로 표시 된 모든 행을 제외 하 고 합니다.When you create a DataTableReader from a DataTable, the resulting DataTableReader object contains one result set with the same data as the DataTable from which it was created, except for any rows that have been marked as deleted. 열이 원래와 동일한 순서로 표시 DataTable합니다.The columns appear in the same order as in the original DataTable. 반환 된 결과의 구조는 원래 스키마와 데이터에 동일한 DataTable입니다.The structure of the returned result is identical in schema and data to the original DataTable. DataTableReader 를 호출 하 여 생성 된를 CreateDataReader 메서드의 DataSet 경우 개체는 여러 결과 집합을 포함 합니다 DataSet 둘 이상의 테이블을 포함 합니다.A DataTableReader that was created by calling the CreateDataReader method of a DataSet object contains multiple result sets if the DataSet contains more than one table. 결과 순서와 동일 합니다 DataTable 개체를 DataTableCollectionDataSet 개체.The results are in the same sequence as the DataTable objects in the DataTableCollection of the DataSet object.

반환된 된 결과 집합의 각 현재 버전만 포함 DataRow; 삭제 표시 된 행은 건너뜁니다.The returned result set contains only the current version of each DataRow; rows that are marked for deletion are skipped.

합니다 DataTableReader 안정적 제공 반복기, 즉 내용의 DataTableReader 반복 하는 동안 기본 컬렉션의 크기를 수정 하는 경우 무효화 되지 않습니다.The DataTableReader provides a stable iterator; that is, the contents of the DataTableReader are not invalidated if the size of the underlying collection is modified during iteration. 예를 들어 하나 이상의 대 한 행을 Rows 컬렉션을 삭제 하거나 반복 내의 현재 위치 하는 동안 제거할는 DataTableReader 적절 하 게 유지 됩니다 및 반복기를 무효화 하지 않습니다.For example, if one or more rows in the Rows collection are deleted or removed during iteration, the current position within the DataTableReader is maintained appropriately and it does not invalidate the iterator.

생성자

DataTableReader(DataTable)

제공된 DataTableReader의 데이터를 사용하여 DataTable 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DataTableReader class by using data from the supplied DataTable.

DataTableReader(DataTable[])

DataTableReader 개체의 제공된 배열을 사용하여 DataTable 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DataTableReader class using the supplied array of DataTable objects.

속성

Depth

DataTableReader의 현재 행에 대한 중첩 수준입니다.The depth of nesting for the current row of the DataTableReader.

FieldCount

현재 행에 있는 열의 수를 반환합니다.Returns the number of columns in the current row.

HasRows

DataTableReader에 하나 이상의 행이 있는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the DataTableReader contains one or more rows.

IsClosed

DataTableReader가 닫혀 있는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the DataTableReader is closed.

Item[Int32]

열 서수가 지정된 경우, 지정된 열의 값을 네이티브 형식으로 가져옵니다.Gets the value of the specified column in its native format given the column ordinal.

Item[String]

열 이름이 지정된 경우, 지정된 열의 값을 네이티브 형식으로 가져옵니다.Gets the value of the specified column in its native format given the column name.

RecordsAffected

SQL 문을 실행하여 삽입, 변경 또는 삭제된 열의 수를 가져옵니다.Gets the number of rows inserted, changed, or deleted by execution of the SQL statement.

VisibleFieldCount

DbDataReader 중에서 숨김 상태가 아닌 필드 수를 가져옵니다.Gets the number of fields in the DbDataReader that are not hidden.

(다음에서 상속됨 DbDataReader)

메서드

Close()

현재 DataTableReader를 닫습니다.Closes the current DataTableReader.

CloseAsync()

DbDataReader 개체를 비동기적으로 닫습니다.Asynchronously closes the DbDataReader object.

(다음에서 상속됨 DbDataReader)
CreateObjRef(Type)

원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(다음에서 상속됨 MarshalByRefObject)
Dispose()

DbDataReader 클래스의 현재 인스턴스에서 사용하는 모든 리소스를 해제합니다.Releases all resources used by the current instance of the DbDataReader class.

(다음에서 상속됨 DbDataReader)
Dispose(Boolean)

DbDataReader에서 사용한 관리되지 않는 리소스를 해제하고 선택적으로 관리되는 리소스를 해제합니다.Releases the unmanaged resources used by the DbDataReader and optionally releases the managed resources.

(다음에서 상속됨 DbDataReader)
DisposeAsync()

DbDataReader 클래스의 현재 인스턴스에서 사용하는 모든 리소스를 비동기식으로 해제합니다.Asynchronously releases all resources used by the current instance of the DbDataReader class.

(다음에서 상속됨 DbDataReader)
Equals(Object)

지정한 개체가 현재 개체와 같은지를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
GetBoolean(Int32)

Boolean으로 지정된 열 값을 가져옵니다.Gets the value of the specified column as a Boolean.

GetByte(Int32)

지정된 열의 값에 해당하는 바이트 값을 가져옵니다.Gets the value of the specified column as a byte.

GetBytes(Int32, Int64, Byte[], Int32, Int32)

지정된 열 오프셋에서 시작되는 바이트 스트림을 지정된 버퍼 오프셋에서 시작하는 배열로 버퍼에 읽어 들입니다.Reads a stream of bytes starting at the specified column offset into the buffer as an array starting at the specified buffer offset.

GetChar(Int32)

지정된 열의 값을 문자로 가져옵니다.Gets the value of the specified column as a character.

GetChars(Int32, Int64, Char[], Int32, Int32)

지정된 열의 값에 해당하는 문자 배열을 반환합니다.Returns the value of the specified column as a character array.

GetData(Int32)

요청된 열의 중첩된 데이터 판독기를 반환합니다.Returns a nested data reader for the requested column.

(다음에서 상속됨 DbDataReader)
GetDataTypeName(Int32)

지정된 열의 데이터 형식을 나타내는 문자열을 가져옵니다.Gets a string representing the data type of the specified column.

GetDateTime(Int32)

지정된 열의 값에 해당하는 DateTime 개체를 가져옵니다.Gets the value of the specified column as a DateTime object.

GetDbDataReader(Int32)

요청된 열 서수에 대한 DbDataReader 개체를 반환합니다. 이 개체는 공급자별 구현으로 재정의할 수 있습니다.Returns a DbDataReader object for the requested column ordinal that can be overridden with a provider-specific implementation.

(다음에서 상속됨 DbDataReader)
GetDecimal(Int32)

Decimal으로 지정된 열 값을 가져옵니다.Gets the value of the specified column as a Decimal.

GetDouble(Int32)

열의 값을 배정밀도 부동 소수점 숫자로 가져옵니다.Gets the value of the column as a double-precision floating point number.

GetEnumerator()

항목 컬렉션 전체에서 반복하는 데 사용할 수 있는 열거자를 반환합니다.Returns an enumerator that can be used to iterate through the item collection.

GetFieldType(Int32)

개체의 데이터 형식인 Type을 가져옵니다.Gets the Type that is the data type of the object.

GetFieldValue<T>(Int32)

지정된 열의 값을 요청된 형식으로 가져옵니다.Gets the value of the specified column as the requested type.

(다음에서 상속됨 DbDataReader)
GetFieldValueAsync<T>(Int32)

지정된 열의 값을 요청된 형식으로 비동기적으로 가져옵니다.Asynchronously gets the value of the specified column as the requested type.

(다음에서 상속됨 DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)

지정된 열의 값을 요청된 형식으로 비동기적으로 가져옵니다.Asynchronously gets the value of the specified column as the requested type.

(다음에서 상속됨 DbDataReader)
GetFloat(Int32)

지정된 열의 값에 해당하는 단정밀도 부동 소수점 숫자를 가져옵니다.Gets the value of the specified column as a single-precision floating point number.

GetGuid(Int32)

지정된 열의 값에 해당하는 GUID(Globally Unique ID)를 가져옵니다.Gets the value of the specified column as a globally-unique identifier (GUID).

GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetInt16(Int32)

지정된 열의 값을 16비트 부호 있는 정수로 가져옵니다.Gets the value of the specified column as a 16-bit signed integer.

GetInt32(Int32)

지정된 열의 값에 해당하는 32비트 부호 있는 정수를 가져옵니다.Gets the value of the specified column as a 32-bit signed integer.

GetInt64(Int32)

지정된 열의 값에 해당하는 64비트 부호 있는 정수를 가져옵니다.Gets the value of the specified column as a 64-bit signed integer.

GetLifetimeService()

이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(다음에서 상속됨 MarshalByRefObject)
GetName(Int32)

String으로 지정된 열 값을 가져옵니다.Gets the value of the specified column as a String.

GetOrdinal(String)

열 이름이 지정된 경우 열 서수를 가져옵니다.Gets the column ordinal, given the name of the column.

GetProviderSpecificFieldType(Int32)

지정된 열의 형식을 공급자별 형식으로 가져옵니다.Gets the type of the specified column in provider-specific format.

GetProviderSpecificValue(Int32)

지정된 열의 값을 공급자별 형식으로 가져옵니다.Gets the value of the specified column in provider-specific format.

GetProviderSpecificValues(Object[])

DataTableReader의 모든 열에 대한 공급자별 형식 정보를 제공된 배열에 채웁니다.Fills the supplied array with provider-specific type information for all the columns in the DataTableReader.

GetSchemaTable()

DataTable의 열 메타데이터를 정의하는 DataTableReader을 반환합니다.Returns a DataTable that describes the column metadata of the DataTableReader.

GetStream(Int32)

지정된 열에서 데이터를 검색하는 스트림을 가져옵니다.Gets a stream to retrieve data from the specified column.

(다음에서 상속됨 DbDataReader)
GetString(Int32)

지정된 열의 값을 문자열로 가져옵니다.Gets the value of the specified column as a string.

GetTextReader(Int32)

열에서 데이터를 검색하는 텍스트 판독기를 가져옵니다.Gets a text reader to retrieve data from the column.

(다음에서 상속됨 DbDataReader)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
GetValue(Int32)

지정된 열의 값을 네이티브 형식으로 가져옵니다.Gets the value of the specified column in its native format.

GetValues(Object[])

현재 행의 열 값으로 개체 배열을 채웁니다.Populates an array of objects with the column values of the current row.

InitializeLifetimeService()

이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다.Obtains a lifetime service object to control the lifetime policy for this instance.

(다음에서 상속됨 MarshalByRefObject)
IsDBNull(Int32)

열의 값이 존재하지 않거나 누락되었는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the column contains non-existent or missing values.

IsDBNullAsync(Int32)

열의 값이 존재하지 않거나 누락되었는지 여부를 나타내는 값을 비동기적으로 가져옵니다.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

(다음에서 상속됨 DbDataReader)
IsDBNullAsync(Int32, CancellationToken)

열의 값이 존재하지 않거나 누락되었는지 여부를 나타내는 값을 비동기적으로 가져옵니다.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

(다음에서 상속됨 DbDataReader)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
MemberwiseClone(Boolean)

현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다.Creates a shallow copy of the current MarshalByRefObject object.

(다음에서 상속됨 MarshalByRefObject)
NextResult()

DataTableReader를 다음 결과 집합(있을 경우)으로 이동합니다.Advances the DataTableReader to the next result set, if any.

NextResultAsync()

일괄 문의 결과를 읽을 때 판독기를 다음 결과로 비동기로 이동합니다.Asynchronously advances the reader to the next result when reading the results of a batch of statements.

(다음에서 상속됨 DbDataReader)
NextResultAsync(CancellationToken)

일괄 문의 결과를 읽을 때 판독기를 다음 결과로 비동기로 이동합니다.Asynchronously advances the reader to the next result when reading the results of a batch of statements.

(다음에서 상속됨 DbDataReader)
Read()

DataTableReader를 다음 레코드로 이동합니다.Advances the DataTableReader to the next record.

ReadAsync()

판독기를 결과 집합의 다음 레코드로 비동기로 이동합니다.Asynchronously advances the reader to the next record in a result set.

(다음에서 상속됨 DbDataReader)
ReadAsync(CancellationToken)

판독기를 결과 집합의 다음 레코드로 비동기로 이동합니다.Asynchronously advances the reader to the next record in a result set.

(다음에서 상속됨 DbDataReader)
ToString()

현재 개체를 나타내는 string을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)

명시적 인터페이스 구현

IDataReader.Close()

이 멤버에 대한 설명은 Close()를 참조하세요.For a description of this member, see Close().

(다음에서 상속됨 DbDataReader)
IDataReader.GetSchemaTable()

이 멤버에 대한 설명은 GetSchemaTable()를 참조하세요.For a description of this member, see GetSchemaTable().

(다음에서 상속됨 DbDataReader)
IDataRecord.GetData(Int32)

이 멤버에 대한 설명은 GetData(Int32)를 참조하세요.For a description of this member, see GetData(Int32).

(다음에서 상속됨 DbDataReader)

확장 메서드

CanGetColumnSchema(DbDataReader)

DbDataReader에서 열 스키마를 가져올 수 있는지를 나타내는 값을 가져옵니다.Gets a value that indicates whether a DbDataReader can get a column schema.

GetColumnSchema(DbDataReader)

DbDataReader에 대한 열 스키마(DbColumn 컬렉션)를 가져옵니다.Gets the column schema (DbColumn collection) for a DbDataReader.

GetBoolean(DbDataReader, String)

지정된 열의 값에 해당하는 Boolean 값을 가져옵니다.Gets the value of the specified column as a Boolean.

GetByte(DbDataReader, String)

지정된 열의 값에 해당하는 바이트 값을 가져옵니다.Gets the value of the specified column as a byte.

GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32)

지정된 인덱스에서 시작하는 지정된 열에서 지정된 바이트 수를 읽은 다음 버퍼의 지정된 위치에서 시작하는 버퍼에 씁니다.Reads a specified number of bytes from the specified column starting at a specified index and writes them to a buffer starting at a specified position in the buffer.

GetChar(DbDataReader, String)

단일 문자로 지정된 열의 값을 가져옵니다.Gets the value of the specified column as a single character.

GetChars(DbDataReader, String, Int64, Char[], Int32, Int32)

지정된 인덱스에서 시작하는 지정된 열에서 지정된 수의 문자를 읽은 다음 지정된 위치에서 시작하는 버퍼에 씁니다.Reads a specified number of characters from a specified column starting at a specified index, and writes them to a buffer starting at a specified position.

GetData(DbDataReader, String)

요청된 열의 중첩된 데이터 판독기를 반환합니다.Returns a nested data reader for the requested column.

GetDataTypeName(DbDataReader, String)

지정된 열의 데이터 형식 이름을 가져옵니다.Gets name of the data type of the specified column.

GetDateTime(DbDataReader, String)

지정된 열의 값에 해당하는 DateTime 개체를 가져옵니다.Gets the value of the specified column as a DateTime object.

GetDecimal(DbDataReader, String)

Decimal으로 지정된 열 값을 가져옵니다.Gets the value of the specified column as a Decimal.

GetDouble(DbDataReader, String)

지정된 열의 값을 배정밀도 부동 소수점 숫자로 가져옵니다.Gets the value of the specified column as a double-precision floating point number.

GetFieldType(DbDataReader, String)

지정된 열의 데이터 형식을 가져옵니다.Gets the data type of the specified column.

GetFieldValue<T>(DbDataReader, String)

지정된 열의 값을 요청된 형식으로 가져옵니다.Gets the value of the specified column as the requested type.

GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)

지정된 열의 값을 요청된 형식으로 비동기적으로 가져옵니다.Asynchronously gets the value of the specified column as the requested type.

GetFloat(DbDataReader, String)

지정된 열의 값에 해당하는 단정밀도 부동 소수점 숫자를 가져옵니다.Gets the value of the specified column as a single-precision floating point number.

GetGuid(DbDataReader, String)

지정된 열의 값을 GUID(Globally Unique Identifier)로 가져옵니다.Gets the value of the specified column as a globally unique identifier (GUID).

GetInt16(DbDataReader, String)

지정된 열의 값을 16비트 부호 있는 정수로 가져옵니다.Gets the value of the specified column as a 16-bit signed integer.

GetInt32(DbDataReader, String)

지정된 열의 값에 해당하는 32비트 부호 있는 정수를 가져옵니다.Gets the value of the specified column as a 32-bit signed integer.

GetInt64(DbDataReader, String)

지정된 열의 값에 해당하는 64비트 부호 있는 정수를 가져옵니다.Gets the value of the specified column as a 64-bit signed integer.

GetProviderSpecificFieldType(DbDataReader, String)

지정된 열의 공급자별 형식을 가져옵니다.Gets the provider-specific type of the specified column.

GetProviderSpecificValue(DbDataReader, String)

지정된 열의 값을 공급자별 형식의 인스턴스로 가져옵니다.Gets the value of the specified column as an instance of a provider-specific type.

GetStream(DbDataReader, String)

지정된 열에서 데이터를 검색하는 스트림을 가져옵니다.Gets a stream to retrieve data from the specified column.

GetString(DbDataReader, String)

지정된 열의 값에 해당하는 String의 인스턴스를 가져옵니다.Gets the value of the specified column as an instance of String.

GetTextReader(DbDataReader, String)

열에서 데이터를 검색하는 텍스트 판독기를 가져옵니다.Gets a text reader to retrieve data from the column.

GetValue(DbDataReader, String)

지정된 열의 값에 해당하는 Object의 인스턴스를 가져옵니다.Gets the value of the specified column as an instance of Object.

IsDBNull(DbDataReader, String)

열이 존재하지 않거나 없는 값을 포함하는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the column contains nonexistent or missing values.

IsDBNullAsync(DbDataReader, String, CancellationToken)

열의 값이 존재하지 않거나 누락되었는지 여부를 나타내는 값을 비동기적으로 가져옵니다.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

Cast<TResult>(IEnumerable)

IEnumerable의 요소를 지정된 형식으로 캐스팅합니다.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

지정된 형식에 따라 IEnumerable의 요소를 필터링합니다.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

쿼리를 병렬화할 수 있도록 합니다.Enables parallelization of a query.

AsQueryable(IEnumerable)

IEnumerableIQueryable로 변환합니다.Converts an IEnumerable to an IQueryable.

적용 대상