SqlCeResultSet 클래스
업데이트, 스크롤 및 바인딩이 가능한 커서입니다.
상속 계층
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 유형에서 다음 멤버를 표시합니다.
생성자
| 이름 | 설명 | |
|---|---|---|
.gif "보호된 메서드") |
SqlCeResultSet | 보안에 중요합니다. 사용하지 마십시오. SqlCeResultSet을 만들려면 SqlCeCommand의 ExecuteResultSet(ResultSetOptions) 메서드를 호출해야 합니다. |
맨 위로 이동
속성
| 이름 | 설명 | |
|---|---|---|
.gif "보호된 속성") |
ContainsListCollection | 인프라입니다. |
.gif "공용 속성") |
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에서 상속) |
맨 위로 이동
메서드
| 이름 | 설명 | |
|---|---|---|
.gif "공용 메서드") |
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 | 현재 레코드의 변경 사항을 서버의 내부 행으로 보냅니다. |
맨 위로 이동
명시적 인터페이스 구현
| 이름 | 설명 | |
|---|---|---|
.gif "명시적 인터페이스 구현") .gif "전용 속성") |
IListSource.ContainsListCollection | |
.gif "전용 메서드") |
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) 멤버는 스레드로부터 안전합니다. 인스턴스 멤버는 스레드로부터의 안전성이 보장되지 않습니다.