SqlCeResultSet 클래스

아티클
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 SqlCeResultSet _
    Inherits SqlCeDataReader _
    Implements IEnumerable, IListSource
‘사용 방법
Dim instance As SqlCeResultSet

public class SqlCeResultSet : SqlCeDataReader, 
    IEnumerable, IListSource

public ref class SqlCeResultSet : public SqlCeDataReader, 
    IEnumerable, IListSource

type SqlCeResultSet =  
    class
        inherit SqlCeDataReader
        interface IEnumerable
        interface IListSource
    end

public class SqlCeResultSet extends SqlCeDataReader implements IEnumerable, IListSource

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

생성자

	이름	설명
	SqlCeResultSet	보안에 중요합니다. 사용하지 마십시오. SqlCeResultSet을 만들려면 SqlCeCommand의 ExecuteResultSet(ResultSetOptions) 메서드를 호출해야 합니다.

맨 위로 이동

속성

	이름	설명
	ContainsListCollection	인프라입니다.
	Depth	현재 행의 중첩 수준을 나타내는 값을 가져옵니다. (SqlCeDataReader에서 상속)
	FieldCount	쿼리의 SELECT 절에 있는 열의 수를 가져옵니다. (SqlCeDataReader에서 상속)
	HasRows	SqlCeDataReader 에 하나 이상의 행이 있는지 여부를 나타내는 값을 가져옵니다. (SqlCeDataReader에서 상속)
	HiddenFieldCount	인프라입니다. (SqlCeDataReader에서 상속)
	IsClosed	데이터 판독기가 닫혔는지 여부를 나타냅니다. (SqlCeDataReader에서 상속)
	Item[Int32]	SqlCeResultSet 의 인덱서 역할을 합니다. (SqlCeDataReader.Item[Int32]을(를) 재정의함)
	Item[String]	SqlCeResultSet 의 인덱서 역할을 합니다. (SqlCeDataReader.Item[String]을(를) 재정의함)
	RecordsAffected	SQL 문으로 변경, 삽입 또는 삭제된 열의 수를 가져옵니다. (SqlCeDataReader에서 상속)
	ResultSetView	SqlCeResultSet 를 컨트롤에 데이터 바인딩할 때 사용됩니다.
	Scrollable	SqlCeResultSet 을 스크롤할 수 있는지 여부를 확인합니다.
	Sensitivity	SqlCeResultSet 의 민감도를 확인합니다.
	Updatable	SqlCeResultSet 의 값을 수정할 수 있는지 여부를 확인합니다.
	VisibleFieldCount	(DbDataReader에서 상속)

맨 위로 이동

메서드

	이름	설명
	Close	SqlCeDataReader 개체를 닫습니다. (SqlCeDataReader에서 상속)
	CreateObjRef	(MarshalByRefObject에서 상속)
	CreateRecord	서버에서 새 행을 만들고 SqlCeUpdatableRecord 개체를 반환합니다.
	Delete	서버에 있는 데이터 원본에서 현재 레코드를 삭제합니다.
	Dispose()	인프라입니다. 이 SqlCeDataReader에서 소비한 리소스를 해제합니다. (SqlCeDataReader에서 상속)
	Dispose(Boolean)	이 SqlCeDataReader에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스도 선택적으로 해제합니다. (SqlCeDataReader에서 상속)
	Equals	(Object에서 상속)
	Finalize	가비지 수집에 의해 SqlCeDataReader가 회수되기 전에 관리되지 않는 리소스를 해제하고 기타 정리 작업을 수행합니다. (SqlCeDataReader에서 상속)
	GetBoolean	지정된 인덱스의 열 값을 boolean 값으로 반환합니다. (SqlCeDataReader.GetBoolean(Int32)을(를) 재정의함)
	GetByte	지정된 인덱스의 열 값을 byte로 반환합니다. (SqlCeDataReader.GetByte(Int32)을(를) 재정의함)
	GetBytes	지정된 필드의 지정된 위치에서 시작하여 바이트 단위의 길이를 버퍼에 복사합니다. (SqlCeDataReader.GetBytes(Int32, Int64, array<Byte[], Int32, Int32)을(를) 재정의함)
	GetChar	.NET Compact Framework Data Provider for SQL Server Compact에서는 지원되지 않습니다. (SqlCeDataReader에서 상속)
	GetChars	지정된 필드의 지정된 위치에서 시작하여 문자 단위의 길이를 버퍼에 복사합니다. (SqlCeDataReader.GetChars(Int32, Int64, array<Char[], Int32, Int32)을(를) 재정의함)
	GetData	(DbDataReader에서 상속)
	GetDataTypeName	원본 데이터 형식의 이름을 가져옵니다. (SqlCeDataReader에서 상속)
	GetDateTime	지정된 인덱스의 열 값을 DateTime으로 반환합니다. (SqlCeDataReader.GetDateTime(Int32)을(를) 재정의함)
	GetDbDataReader	(DbDataReader에서 상속)
	GetDecimal	지정된 인덱스의 열 값을 Double로 반환합니다. (SqlCeDataReader.GetDecimal(Int32)을(를) 재정의함)
	GetDouble	지정된 인덱스의 열 값을 Double로 반환합니다. (SqlCeDataReader.GetDouble(Int32)을(를) 재정의함)
	GetEnumerator	데이터 판독기에서 행을 반복하는 데 사용할 수 있는 IEnumerator를 반환합니다. (SqlCeDataReader.GetEnumerator()을(를) 재정의함)
	GetFieldType	개체의 데이터 형식인 Type을 가져옵니다. (SqlCeDataReader에서 상속)
	GetFloat	지정된 인덱스의 열 값을 Float로 반환합니다. (SqlCeDataReader.GetFloat(Int32)을(를) 재정의함)
	GetGuid	지정된 인덱스의 열 값을 GUID로 반환합니다. (SqlCeDataReader.GetGuid(Int32)을(를) 재정의함)
	GetHashCode	(Object에서 상속)
	GetInt16	지정된 인덱스의 열 값을 Int16으로 반환합니다. (SqlCeDataReader.GetInt16(Int32)을(를) 재정의함)
	GetInt32	지정된 인덱스의 열 값을 Int32로 반환합니다. (SqlCeDataReader.GetInt32(Int32)을(를) 재정의함)
	GetInt64	지정된 인덱스의 열 값을 Int64로 반환합니다. (SqlCeDataReader.GetInt64(Int32)을(를) 재정의함)
	GetLifetimeService	(MarshalByRefObject에서 상속)
	GetList	ResultSetView 의 인스턴스를 반환합니다.
	GetName	지정된 열의 이름을 가져옵니다. (SqlCeDataReader에서 상속)
	GetOrdinal	열 이름이 지정된 경우 열 서수를 가져옵니다. (SqlCeDataReader에서 상속)
	GetProviderSpecificFieldType	내부 공급자별 필드 형식의 표현인 Object를 가져옵니다. (SqlCeDataReader에서 상속)
	GetProviderSpecificValue	(DbDataReader에서 상속)
	GetProviderSpecificValues	(DbDataReader에서 상속)
	GetSchemaTable	SqlCeDataReader 의 열 메타데이터를 설명하는 DataTable을 반환합니다. (SqlCeDataReader에서 상속)
	GetSqlBinary	지정된 인덱스의 열 값을 SqlBinary 형식으로 반환합니다. (SqlCeDataReader.GetSqlBinary(Int32)을(를) 재정의함)
	GetSqlBoolean	지정된 인덱스의 열 값을 SqlBoolean 형식으로 반환합니다. (SqlCeDataReader.GetSqlBoolean(Int32)을(를) 재정의함)
	GetSqlByte	지정된 인덱스의 열 값을 SqlByte 형식으로 반환합니다. (SqlCeDataReader.GetSqlByte(Int32)을(를) 재정의함)
	GetSqlDateTime	지정된 인덱스의 열 값을 SqlDateTime 형식으로 반환합니다. (SqlCeDataReader.GetSqlDateTime(Int32)을(를) 재정의함)
	GetSqlDecimal	지정된 인덱스의 열 값을 SqlDecimal 형식으로 반환합니다. (SqlCeDataReader.GetSqlDecimal(Int32)을(를) 재정의함)
	GetSqlDouble	지정된 인덱스의 열 값을 SqlDouble 형식으로 반환합니다. (SqlCeDataReader.GetSqlDouble(Int32)을(를) 재정의함)
	GetSqlGuid	지정된 인덱스의 열 값을 SqlGuid 형식으로 반환합니다. (SqlCeDataReader.GetSqlGuid(Int32)을(를) 재정의함)
	GetSqlInt16	지정된 인덱스의 열 값을 SqlInt16 형식으로 반환합니다. (SqlCeDataReader.GetSqlInt16(Int32)을(를) 재정의함)
	GetSqlInt32	지정된 인덱스의 열 값을 SqlInt32 형식으로 반환합니다. (SqlCeDataReader.GetSqlInt32(Int32)을(를) 재정의함)
	GetSqlInt64	지정된 인덱스의 열 값을 SqlInt64 형식으로 반환합니다. (SqlCeDataReader.GetSqlInt64(Int32)을(를) 재정의함)
	GetSqlMetaData	지정된 열과 관련된 메타데이터 정보를 반환합니다.
	GetSqlMoney	지정된 인덱스의 열 값을 SqlMoney 형식으로 반환합니다. (SqlCeDataReader.GetSqlMoney(Int32)을(를) 재정의함)
	GetSqlSingle	지정된 인덱스의 열 값을 SqlSingle 형식으로 반환합니다. (SqlCeDataReader.GetSqlSingle(Int32)을(를) 재정의함)
	GetSqlString	지정된 인덱스의 열 값을 SqlString 형식으로 반환합니다. (SqlCeDataReader.GetSqlString(Int32)을(를) 재정의함)
	GetString	지정된 인덱스의 열 값을 String 형식으로 반환합니다. (SqlCeDataReader.GetString(Int32)을(를) 재정의함)
	GetType	(Object에서 상속)
	GetValue	지정된 필드의 값을 반환합니다. (SqlCeDataReader.GetValue(Int32)을(를) 재정의함)
	GetValues	지정된 레코드의 모든 필드로 이루어진 배열을 검색합니다. (SqlCeDataReader.GetValues(array<Object[])을(를) 재정의함)
	InitializeLifetimeService	(MarshalByRefObject에서 상속)
	Insert(SqlCeUpdatableRecord)	지정된 SqlCeUpdatableRecord를 내부 행 집합에 삽입합니다.
	Insert(SqlCeUpdatableRecord, DbInsertOptions)	지정한 SqlCeUpdatableRecord를 내부 행 집합에 삽입하고 커서가 배치되는 방식을 지정합니다.
	IsCommandBehavior	지정된 CommandBehavior가 이 SqlCeDataReader의 명령 동작과 일치하는지 여부를 확인합니다. (SqlCeDataReader에서 상속)
	IsDBNull	지정된 서수 위치의 필드가 null인지 여부를 확인합니다. (SqlCeDataReader.IsDBNull(Int32)을(를) 재정의함)
	IsSetAsDefault	지정된 서수 위치의 필드가 내부 기본값을 사용하도록 표시되었는지 여부를 확인합니다.
	MemberwiseClone()	(Object에서 상속)
	MemberwiseClone(Boolean)	(MarshalByRefObject에서 상속)
	NextResult	.NET Compact Framework Data Provider for SQL Server Compact에서는 지원되지 않습니다. (SqlCeDataReader에서 상속)
	OnMove	인프라입니다. (SqlCeDataReader.OnMove()을(를) 재정의함)
	Read	SqlCeDataReader 를 다음 레코드로 이동합니다. (SqlCeDataReader에서 상속)
	ReadAbsolute	판독기를 ResultSet의 특정 레코드로 이동합니다.
	ReadFirst	판독기를 ResultSet의 첫 번째 레코드에 배치합니다.
	ReadLast	판독기를 ResultSet의 마지막 레코드에 배치합니다.
	ReadPrevious	현재 레코드 이전의 레코드에 판독기를 배치합니다.
	ReadRelative	현재 위치에서 지정된 위치만큼 판독기를 이동합니다.
	Seek	지정된 매개 변수와 일치하는 인덱싱된 값을 가진 레코드에 SqlCeDataReader를 적용합니다. (SqlCeDataReader에서 상속)
	SetBoolean	지정된 열 값을 전달된 Boolean 값으로 설정합니다.
	SetByte	지정된 열 값을 전달된 Byte 값으로 설정합니다.
	SetBytes	지정된 버퍼에서 바이트 단위의 길이를 필드 내의 지정된 위치에서 시작하여 지정된 열에 복사합니다.
	SetChar	지정된 열 값을 전달된 Char 값으로 설정합니다.
	SetChars	지정된 버퍼에서 char 단위의 길이를 필드 내의 지정된 위치에서 시작하여 지정된 열에 복사합니다.
	SetDateTime	지정된 열 값을 전달된 DateTime 값으로 설정합니다.
	SetDecimal	지정된 열 값을 전달된 Decimal 값으로 설정합니다.
	SetDefault	지정된 열을 기본값으로 설정합니다.
	SetDouble	지정된 열 값을 전달된 Double 값으로 설정합니다.
	SetFloat	지정된 열 값을 전달된 Float 값으로 설정합니다.
	SetGuid	지정된 열 값을 전달된 Guid 값으로 설정합니다.
	SetInt16	지정된 열 값을 전달된 Int16 값으로 설정합니다.
	SetInt32	지정된 열 값을 전달된 Int32 값으로 설정합니다.
	SetInt64	지정된 열 값을 전달된 Int64 값으로 설정합니다.
	SetObjectRef	개체를 지정된 위치의 열에 바인딩합니다.
	SetSqlBinary	지정된 열 값을 전달된 SqlBinary 값으로 설정합니다.
	SetSqlBoolean	지정된 열 값을 전달된 SqlBoolean 값으로 설정합니다.
	SetSqlByte	지정된 열 값을 전달된 SqlByte 값으로 설정합니다.
	SetSqlDateTime	지정된 열 값을 전달된 SqlDateTime 값으로 설정합니다.
	SetSqlDecimal	지정된 열 값을 전달된 SqlDecimal 값으로 설정합니다.
	SetSqlDouble	지정된 열 값을 전달된 SqlDouble 값으로 설정합니다.
	SetSqlGuid	지정된 열 값을 전달된 SqlGuid 값으로 설정합니다.
	SetSqlInt16	지정된 열 값을 전달된 SqlInt16 값으로 설정합니다.
	SetSqlInt32	지정된 열 값을 전달된 SqlInt32 값으로 설정합니다.
	SetSqlInt64	지정된 열 값을 전달된 SqlInt64 값으로 설정합니다.
	SetSqlMoney	지정된 열 값을 전달된 SqlMoney 값으로 설정합니다.
	SetSqlSingle	지정된 열 값을 전달된 SqlSingle 값으로 설정합니다.
	SetSqlString	지정된 열 값을 전달된 SqlString 값으로 설정합니다.
	SetString	지정된 열 값을 전달된 String 값으로 설정합니다.
	SetValue	지정된 열 값을 전달된 값으로 설정합니다.
	SetValues	지정된 레코드의 각 필드를 지정된 배열의 해당 값으로 설정합니다.
	ToString	(Object에서 상속)
	Update	현재 레코드의 변경 사항을 서버의 내부 행으로 보냅니다.

맨 위로 이동

명시적 인터페이스 구현

	이름	설명
	IListSource.ContainsListCollection
	IEnumerable.GetEnumerator
	IListSource.GetList
	IDataRecord.GetData	(DbDataReader에서 상속)

맨 위로 이동

주의

이전 버전의 SQL Server Compact에서는 데이터에 컨트롤을 바인딩하려면 DataSet을 사용해야 합니다. SqlCeDataReader는 DataSet보다 높은 성능을 제공하지만 정방향 전용이고 업데이트는 할 수 없는 커서입니다. SQL Server Compact에서 SqlCeResultSet는 SqlCeDataReader와 비슷한 성능에 DataSet의 업데이트 및 스크롤 기능을 결합하여 제공합니다.

SqlCeResultSet을 만들려면 개체의 생성자를 사용하는 대신 ExecuteResultSet 메서드를 호출해야 합니다.

ResultSetOptions를 사용하여 SqlCeResultSet의 스크롤 기능, 업데이트 기능 및 민감도를 지정할 수 있습니다. 민감도는 SqlCeResultSet이 내부 또는 외부 요인에 의한 변경 사항을 인식할 수 있는지 여부를 결정합니다.

SqlCeDataReader의 기본 위치는 첫 번째 레코드 앞입니다. 데이터에 액세스하려면 읽기를 호출해야 합니다. 첫 번째 읽기는 커서를 첫 번째 레코드에 배치합니다. 동작은 SqlCeResultSet.Read 메서드의 동작과 다릅니다. SqlCeResultSet의 기본 위치는 첫 번째 레코드입니다. SqlCeResultSet을 만든 후 바로 SqlCeResultSet.Read 메서드를 호출하면 커서가 두 번째 레코드로 이동합니다.

예

다음 예제에서는 SQL Server Compact 데이터베이스를 새로 만듭니다. 그런 다음 데이터 집합을 데이터로 채우도록 SqlCeResultSet이 초기화됩니다.

Dim conn As SqlCeConnection = Nothing

Try
    File.Delete("Test.sdf")

    Dim engine As New SqlCeEngine("Data Source = Test.sdf")
    engine.CreateDatabase()

    conn = New SqlCeConnection("Data Source = Test.sdf")
    conn.Open()

    Dim cmd As SqlCeCommand = conn.CreateCommand()
    cmd.CommandText = "CREATE TABLE myTable (col1 INT, col2 MONEY, col3 NVARCHAR(200))"
    cmd.ExecuteNonQuery()

    cmd.CommandText = "SELECT * FROM myTable"

    Dim rs As SqlCeResultSet = cmd.ExecuteResultSet(ResultSetOptions.Updatable Or ResultSetOptions.Scrollable)

    Dim rec As SqlCeUpdatableRecord = rs.CreateRecord()

    rec.SetInt32(0, 34)
    rec.SetDecimal(1, System.Convert.ToDecimal(44.66))
    rec.SetString(2, "Sample text")

    rs.Insert(rec)
Catch e As Exception
    MessageBox.Show(e.Message)
Finally
    conn.Close()
End Try

SqlCeConnection conn = null;

try
{
    File.Delete("Test.sdf");

    SqlCeEngine engine = new SqlCeEngine("Data Source = Test.sdf");
    engine.CreateDatabase();

    conn = new SqlCeConnection("Data Source = Test.sdf");
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "CREATE TABLE myTable (col1 INT, col2 MONEY, col3 NVARCHAR(200))";
    cmd.ExecuteNonQuery();

    cmd.CommandText = "SELECT * FROM myTable";

    SqlCeResultSet rs = cmd.ExecuteResultSet(ResultSetOptions.Updatable | 
        ResultSetOptions.Scrollable);

    SqlCeUpdatableRecord rec = rs.CreateRecord();

    rec.SetInt32(0, 34);
    rec.SetDecimal(1, (decimal)44.66);
    rec.SetString(2, "Sample text");

    rs.Insert(rec);
}
catch (Exception e)
{
    MessageBox.Show(e.Message);
}
finally
{
    conn.Close();
}

스레드 보안

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

참고 항목

참조

System.Data.SqlServerCe 네임스페이스

SqlCeResultSet 클래스

상속 계층

구문

생성자

속성

메서드

명시적 인터페이스 구현

주의

예

스레드 보안

참고 항목

참조

추가 리소스