SqlCeDataReader 클래스

아티클
05/27/2011

데이터 원본에서 데이터 행의 정방향 전용 스트림을 읽는 방법을 제공합니다. 이 클래스는 상속될 수 없습니다.

상속 계층

System.Object
  System.MarshalByRefObject
    System.Data.Common.DbDataReader
      System.Data.SqlServerCe.SqlCeDataReader
        System.Data.SqlServerCe.SqlCeResultSet

네임스페이스: System.Data.SqlServerCe
어셈블리: System.Data.SqlServerCe(System.Data.SqlServerCe.dll)

구문

‘선언
Public Class SqlCeDataReader _
    Inherits DbDataReader
‘사용 방법
Dim instance As SqlCeDataReader

public class SqlCeDataReader : DbDataReader

public ref class SqlCeDataReader : public DbDataReader

type SqlCeDataReader =  
    class
        inherit DbDataReader
    end

public class SqlCeDataReader extends DbDataReader

SqlCeDataReader 유형에서 다음 멤버를 표시합니다.

속성

	이름	설명
	Depth	현재 행의 중첩 수준을 나타내는 값을 가져옵니다. (DbDataReader.Depth을(를) 재정의함)
	FieldCount	쿼리의 SELECT 절에 있는 열의 수를 가져옵니다. (DbDataReader.FieldCount을(를) 재정의함)
	HasRows	SqlCeDataReader 에 하나 이상의 행이 있는지 여부를 나타내는 값을 가져옵니다. (DbDataReader.HasRows을(를) 재정의함)
	HiddenFieldCount	인프라입니다.
	IsClosed	데이터 판독기가 닫혔는지 여부를 나타냅니다. (DbDataReader.IsClosed을(를) 재정의함)
	Item[Int32]	열 서수가 지정된 경우, 지정된 열의 값을 네이티브 형식으로 가져옵니다. (DbDataReader.Item[Int32]을(를) 재정의함)
	Item[String]	열 이름이 지정된 경우, 지정된 열의 값을 네이티브 형식으로 가져옵니다. (DbDataReader.Item[String]을(를) 재정의함)
	RecordsAffected	SQL 문으로 변경, 삽입 또는 삭제된 열의 수를 가져옵니다. (DbDataReader.RecordsAffected을(를) 재정의함)
	VisibleFieldCount	(DbDataReader에서 상속)

맨 위로 이동

메서드

	이름	설명
	Close	SqlCeDataReader 개체를 닫습니다. (DbDataReader.Close()을(를) 재정의함)
	CreateObjRef	(MarshalByRefObject에서 상속)
	Dispose()	인프라입니다. 이 SqlCeDataReader에서 소비한 리소스를 해제합니다.
	Dispose(Boolean)	이 SqlCeDataReader에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스도 선택적으로 해제합니다. (DbDataReader.Dispose(Boolean)을(를) 재정의함)
	Equals	(Object에서 상속)
	Finalize	가비지 수집에 의해 SqlCeDataReader가 회수되기 전에 관리되지 않는 리소스를 해제하고 기타 정리 작업을 수행합니다. (Object.Finalize()을(를) 재정의함)
	GetBoolean	지정된 열의 값을 부울로 가져옵니다. (DbDataReader.GetBoolean(Int32)을(를) 재정의함)
	GetByte	지정된 열의 값을 바이트로 가져옵니다. (DbDataReader.GetByte(Int32)을(를) 재정의함)
	GetBytes	지정된 버퍼 오프셋에서 시작하는 배열로서 지정된 열 오프셋에서 버퍼로 바이트의 스트림을 읽습니다. (DbDataReader.GetBytes(Int32, Int64, array<Byte[], Int32, Int32)을(를) 재정의함)
	GetChar	.NET Compact Framework Data Provider for SQL Server Compact에서는 지원되지 않습니다. (DbDataReader.GetChar(Int32)을(를) 재정의함)
	GetChars	지정된 버퍼 오프셋에서 시작하는 배열로서 지정된 열 오프셋에서 버퍼로 문자의 스트림을 읽습니다. (DbDataReader.GetChars(Int32, Int64, array<Char[], Int32, Int32)을(를) 재정의함)
	GetData	(DbDataReader에서 상속)
	GetDataTypeName	원본 데이터 형식의 이름을 가져옵니다. (DbDataReader.GetDataTypeName(Int32)을(를) 재정의함)
	GetDateTime	지정된 열의 값을 DateTime 개체로 가져옵니다. (DbDataReader.GetDateTime(Int32)을(를) 재정의함)
	GetDbDataReader	(DbDataReader에서 상속)
	GetDecimal	지정된 열의 값을 Decimal 개체로 가져옵니다. (DbDataReader.GetDecimal(Int32)을(를) 재정의함)
	GetDouble	지정된 열의 값을 배정밀도 부동 소수점 숫자로 가져옵니다. (DbDataReader.GetDouble(Int32)을(를) 재정의함)
	GetEnumerator	인프라입니다. (DbDataReader.GetEnumerator()을(를) 재정의함)
	GetFieldType	개체의 데이터 형식인 Type을 가져옵니다. (DbDataReader.GetFieldType(Int32)을(를) 재정의함)
	GetFloat	지정된 열의 값을 단정밀도 부동 소수점 숫자로 가져옵니다. (DbDataReader.GetFloat(Int32)을(를) 재정의함)
	GetGuid	지정된 열의 값을 GUID(Globally Unique Identifier)로 가져옵니다. (DbDataReader.GetGuid(Int32)을(를) 재정의함)
	GetHashCode	(Object에서 상속)
	GetInt16	지정된 열의 값을 16비트 부호 있는 정수로 가져옵니다. (DbDataReader.GetInt16(Int32)을(를) 재정의함)
	GetInt32	지정된 열의 값을 32비트 부호 있는 정수로 가져옵니다. (DbDataReader.GetInt32(Int32)을(를) 재정의함)
	GetInt64	지정된 열의 값을 64비트 부호 있는 정수로 가져옵니다. (DbDataReader.GetInt64(Int32)을(를) 재정의함)
	GetLifetimeService	(MarshalByRefObject에서 상속)
	GetName	지정된 열의 이름을 가져옵니다. (DbDataReader.GetName(Int32)을(를) 재정의함)
	GetOrdinal	열 이름이 지정된 경우 열 서수를 가져옵니다. (DbDataReader.GetOrdinal(String)을(를) 재정의함)
	GetProviderSpecificFieldType	내부 공급자별 필드 형식의 표현인 Object를 가져옵니다. (DbDataReader.GetProviderSpecificFieldType(Int32)을(를) 재정의함)
	GetProviderSpecificValue	(DbDataReader에서 상속)
	GetProviderSpecificValues	(DbDataReader에서 상속)
	GetSchemaTable	SqlCeDataReader 의 열 메타데이터를 설명하는 DataTable을 반환합니다. (DbDataReader.GetSchemaTable()을(를) 재정의함)
	GetSqlBinary	SqlBinary 로 지정된 열 값을 가져옵니다.
	GetSqlBoolean	SqlBoolean 으로 지정된 열 값을 가져옵니다.
	GetSqlByte	SqlByte 로 지정된 열 값을 가져옵니다.
	GetSqlDateTime	SqlDateTime 으로 지정된 열 값을 가져옵니다.
	GetSqlDecimal	SqlDecimal 로 지정된 열 값을 가져옵니다.
	GetSqlDouble	SqlDouble 로 지정된 열 값을 가져옵니다.
	GetSqlGuid	SqlGuid 로 지정된 열 값을 가져옵니다.
	GetSqlInt16	SqlInt16 으로 지정된 열 값을 가져옵니다.
	GetSqlInt32	SqlInt32 로 지정된 열 값을 가져옵니다.
	GetSqlInt64	SqlInt64 로 지정된 열 값을 가져옵니다.
	GetSqlMoney	SqlMoney 로 지정된 열 값을 가져옵니다.
	GetSqlSingle	SqlSingle 로 지정된 열 값을 가져옵니다.
	GetSqlString	SqlString 으로 지정된 열 값을 가져옵니다.
	GetString	지정된 열의 값을 문자열로 가져옵니다. (DbDataReader.GetString(Int32)을(를) 재정의함)
	GetType	(Object에서 상속)
	GetValue	지정된 서수에서 네이티브 형식으로 열의 값을 가져옵니다. (DbDataReader.GetValue(Int32)을(를) 재정의함)
	GetValues	현재 행에 있는 모든 특성 열을 가져옵니다. (DbDataReader.GetValues(array<Object[])을(를) 재정의함)
	InitializeLifetimeService	(MarshalByRefObject에서 상속)
	IsCommandBehavior	지정된 CommandBehavior가 이 SqlCeDataReader의 명령 동작과 일치하는지 여부를 확인합니다.
	IsDBNull	열이 존재하지 않거나 없는 값을 포함하는지 여부를 나타내는 값을 가져옵니다. (DbDataReader.IsDBNull(Int32)을(를) 재정의함)
	MemberwiseClone()	(Object에서 상속)
	MemberwiseClone(Boolean)	(MarshalByRefObject에서 상속)
	NextResult	.NET Compact Framework Data Provider for SQL Server Compact에서는 지원되지 않습니다. (DbDataReader.NextResult()을(를) 재정의함)
	OnMove	인프라입니다.
	Read	SqlCeDataReader 를 다음 레코드로 이동합니다. (DbDataReader.Read()을(를) 재정의함)
	Seek	지정된 매개 변수와 일치하는 인덱싱된 값을 가진 레코드에 SqlCeDataReader를 적용합니다.
	ToString	(Object에서 상속)

맨 위로 이동

명시적 인터페이스 구현

	이름	설명
	IDataRecord.GetData	(DbDataReader에서 상속)

맨 위로 이동

주의

SqlCeDataReader를 만들려면, 생성자를 직접 사용하지 않고 SqlCeCommand 개체의 ExecuteReader 메서드를 호출해야 합니다.

SqlCeDataReader 사용 중에는 관련 SqlCeConnection이 SqlCeDataReader의 역할을 수행합니다. 이 상태에서 같은 연결에 여러 판독기를 만들 수 있습니다.

데이터를 읽는 동안 다른 프로세스나 스레드에서 결과 집합을 변경하면 SqlCeDataReader의 사용자가 이를 볼 수 있지만 세부 동작은 이러한 상황이 발생한 시점에 따라 달라집니다.

IsClosed와 RecordsAffected는 SqlCeDataReader를 닫은 후에 호출할 수 있는 유일한 속성입니다. SqlCeDataReader가 존재하는 동안 언제나 RecordsAffected 속성에 액세스할 수 있지만, RecordsAffected의 값을 반환하기 전에 항상 Close를 호출하여 반환 값이 정확하도록 합니다.

예

다음 예제에서는 SqlCeConnection, SqlCeCommand, SqlCeDataReader 등을 만듭니다. 예제에서는 데이터를 읽어서 콘솔에 쓴 다음 SqlCeDataReader와 SqlCeConnection을 닫습니다.

Dim conn As SqlCeConnection = Nothing
Dim cmd As SqlCeCommand = Nothing
Dim rdr As SqlCeDataReader = Nothing

Try
    ' Open the connection and create a SQL command
    '
    conn = New SqlCeConnection("Data Source = AdventureWorks.sdf")
    conn.Open()

    cmd = New SqlCeCommand("SELECT * FROM DimEmployee", conn)

    rdr = cmd.ExecuteReader()

    ' Iterate through the results
    '
    While rdr.Read()
        Dim employeeID As Integer = rdr.GetInt32(0) ' or: rdr["EmployeeKey"];
        Dim lastName As String = rdr.GetString(5) ' or: rdr["FirstName"];
    End While

    ' Always dispose data readers and commands as soon as practicable
    '
    rdr.Close()
    cmd.Dispose()
Finally
    ' Close the connection when no longer needed
    '
    conn.Close()
End Try

SqlCeConnection conn = null;
SqlCeCommand cmd = null;
SqlCeDataReader rdr = null;

try
{
    // Open the connection and create a SQL command
    //
    conn = new SqlCeConnection("Data Source = AdventureWorks.sdf");
    conn.Open();

    cmd = new SqlCeCommand("SELECT * FROM DimEmployee", conn);

    rdr = cmd.ExecuteReader();

    // Iterate through the results
    //
    while (rdr.Read())
    {
        int employeeID = rdr.GetInt32(0);   // or: rdr["EmployeeKey"];
        string lastName = rdr.GetString(5); // or: rdr["FirstName"];
    }

    // Always dispose data readers and commands as soon as practicable
    //
    rdr.Close();
    cmd.Dispose();
}
finally
{
    // Close the connection when no longer needed
    //
    conn.Close();
}

스레드 보안

이 형식의 모든 public static(Microsoft Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인스턴스 멤버는 스레드로부터의 안전성이 보장되지 않습니다.

참고 항목

참조

System.Data.SqlServerCe 네임스페이스

SqlCeDataReader 클래스

상속 계층

구문

속성

메서드

명시적 인터페이스 구현

주의

예

스레드 보안

참고 항목

참조

추가 리소스