SqlCeCommand 클래스

데이터 원본에 대해 실행할 SQL 문을 나타냅니다.

상속 계층

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Data.Common.DbCommand
        System.Data.SqlServerCe.SqlCeCommand

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

구문

‘선언
Public NotInheritable Class SqlCeCommand _
    Inherits DbCommand _
    Implements ICloneable
‘사용 방법
Dim instance As SqlCeCommand

public sealed class SqlCeCommand : DbCommand, 
    ICloneable

public ref class SqlCeCommand sealed : public DbCommand, 
    ICloneable

[<SealedAttribute>]
type SqlCeCommand =  
    class
        inherit DbCommand
        interface ICloneable
    end

public final class SqlCeCommand extends DbCommand implements ICloneable

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

생성자

	이름	설명
	SqlCeCommand()	SqlCeCommand 클래스의 새 인스턴스를 초기화합니다.
	SqlCeCommand(String)	쿼리 텍스트를 사용하여 SqlCeCommand 클래스의 새 인스턴스를 초기화합니다.
	SqlCeCommand(String, SqlCeConnection)	쿼리의 텍스트와 SqlCeConnection을 사용하여 SqlCeCommand 클래스의 새 인스턴스를 초기화합니다.
	SqlCeCommand(String, SqlCeConnection, SqlCeTransaction)	쿼리의 텍스트, SqlCeConnection, SqlCeTransaction 등을 사용하여 SqlCeCommand 클래스의 새 인스턴스를 초기화합니다.

맨 위로 이동

속성

	이름	설명
	CanRaiseEvents	(Component에서 상속)
	CommandText	데이터 원본을 실행할 SQL 문을 가져오거나 설정합니다. (DbCommand.CommandText을(를) 재정의함)
	CommandTimeout	명령 실행을 종료하고 오류를 생성하기 전 대기 시간을 가져오거나 설정합니다. (DbCommand.CommandTimeout을(를) 재정의함)
	CommandType	CommandText 속성을 해석하는 방법을 나타내는 값을 가져오거나 설정합니다. (DbCommand.CommandType을(를) 재정의함)
	Connection	SqlCeCommand 의 이 인스턴스에서 사용되는 SqlCeConnection을 가져오거나 설정합니다.
	Container	(Component에서 상속)
	DbConnection	(DbCommand에서 상속)
	DbParameterCollection	(DbCommand에서 상속)
	DbTransaction	(DbCommand에서 상속)
	DesignMode	(Component에서 상속)
	DesignTimeVisible	Get은 항상 false를 반환하고, Set은 항상 NotSupportedException을 throw합니다. (DbCommand.DesignTimeVisible을(를) 재정의함)
	Events	(Component에서 상속)
	IndexName	열어 놓을 인덱스를 지정합니다.
	Parameters	SqlCeParameterCollection 을 가져옵니다.
	Site	(Component에서 상속)
	Transaction	SqlCeCommand 가 실행되는 트랜잭션을 가져오거나 설정합니다.
	UpdatedRowSource	DbDataAdapter 의 Update 메서드에 의해 사용될 때 명령 결과가 DataRow에 적용되는 방법을 가져오거나 설정합니다. 이 속성을 .NET Compact Framework Data Provider for SQL Server Compact에서 사용해서는 안 됩니다. (DbCommand.UpdatedRowSource을(를) 재정의함)

맨 위로 이동

메서드

	이름	설명
	Cancel	SqlCeCommand 의 실행을 취소하려고 시도합니다. (DbCommand.Cancel()을(를) 재정의함)
	CreateDbParameter	(DbCommand에서 상속)
	CreateObjRef	(MarshalByRefObject에서 상속)
	CreateParameter	SqlCeParameter 개체의 새 인스턴스를 만듭니다.
	Dispose()	(Component에서 상속)
	Dispose(Boolean)	(Component에서 상속)
	Equals	(Object에서 상속)
	ExecuteDbDataReader	(DbCommand에서 상속)
	ExecuteNonQuery	SqlCeConnection 에 대해 SQL 문을 실행하고 영향 받는 행의 수를 반환합니다. (DbCommand.ExecuteNonQuery()을(를) 재정의함)
	ExecuteReader()	CommandText 를 Connection에 보내고, SqlCeDataReader를 빌드합니다.
	ExecuteReader(CommandBehavior)	CommandText 를 Connection으로 보내고, CommandBehavior 값 중 하나를 사용하여 SqlCeDataReader를 빌드합니다.
	ExecuteResultSet(ResultSetOptions)	CommandText 를 Connection으로 보내고 ResultSetOptions를 사용하여 SqlCeResultSet를 빌드합니다.
	ExecuteResultSet(ResultSetOptions, SqlCeResultSet)	CommandText 를 Connection으로 보내고 ResultSetOptions를 사용하여 SqlCeResultSet를 빌드합니다.
	ExecuteScalar	쿼리를 실행하고 쿼리에서 반환된 결과 집합의 첫 번째 행의 첫 번째 열을 반환합니다. 추가 열이나 행은 무시됩니다. (DbCommand.ExecuteScalar()을(를) 재정의함)
	Finalize	(Component에서 상속)
	GetHashCode	(Object에서 상속)
	GetLifetimeService	(MarshalByRefObject에서 상속)
	GetService	(Component에서 상속)
	GetType	(Object에서 상속)
	InitializeLifetimeService	(MarshalByRefObject에서 상속)
	MemberwiseClone()	(Object에서 상속)
	MemberwiseClone(Boolean)	(MarshalByRefObject에서 상속)
	Prepare	데이터 원본에 명령의 준비 버전이나 컴파일 버전을 만듭니다. (DbCommand.Prepare()을(를) 재정의함)
	SetRange	SqlCeDataReader 가 읽을 행의 집합을 제한합니다.
	ToString	(Component에서 상속)

맨 위로 이동

이벤트

	이름	설명
	Disposed	(Component에서 상속)

맨 위로 이동

명시적 인터페이스 구현

	이름	설명
	ICloneable.Clone
	IDbCommand.Connection	(DbCommand에서 상속)
	IDbCommand.CreateParameter	(DbCommand에서 상속)
	IDbCommand.ExecuteReader()	(DbCommand에서 상속)
	IDbCommand.ExecuteReader(CommandBehavior)	(DbCommand에서 상속)
	IDbCommand.Parameters	(DbCommand에서 상속)
	IDbCommand.Transaction	(DbCommand에서 상속)

맨 위로 이동

주의

SqlCeCommand의 인스턴스가 만들어지면 초기 값에 읽기/쓰기 속성이 지정됩니다. 이러한 값에 대한 목록은 SqlCeCommand 생성자를 참조하십시오.

SqlCeCommand의 특징은 데이터 원본에서 명령을 실행하는 다음 메서드입니다.

Data Provider for SQL Server Compact에서는 일괄 쿼리를 지원하지 않습니다. 명령의 형식은 다음과 같으며

Select * from Customers 다음과 같지 않아야 합니다. Select * from Customers; Select * from Orders;

System.Data.SqlClient에서 생성된 코드를 사용하는 경우 이 제한을 따르도록 쿼리를 변경해야 할 수도 있습니다.

SQL Server Compact에서는 같은 연결을 공유하는 여러 개의 명령뿐 아니라 여러 개의 동시 연결도 지원합니다. 즉, 같은 연결에서 SqlCeDataReader의 여러 인스턴스를 가질 수 있습니다. 이 동작은 System.Data.SqlClient의 동작과 다릅니다.

SqlCeCommand를 실행하는 메서드에서 심각한 SqlCeException이 생성되면 SqlCeConnection이 끊길 수도 있습니다. 그러나 다시 연결하여 계속할 수 있습니다.

예

다음 예제에서는 SqlCeCommand를 SqlCeConnection과 함께 사용하여 데이터베이스에서 행을 선택합니다.

Dim query As String = "SELECT [Order ID], [Customer] FROM Orders"
Dim conn As New SqlCeConnection(connString)
Dim cmd As New SqlCeCommand(query, conn)

conn.Open()
Dim rdr As SqlCeDataReader = cmd.ExecuteReader()

Try
    ' Iterate through the results
    '
    While rdr.Read()
        Dim val1 As Integer = rdr.GetInt32(0)
        Dim val2 As String = rdr.GetString(1)
    End While
Finally
    ' Always call Close when done reading
    '
    rdr.Close()

    ' Always call Close when done reading
    '
    conn.Close()
End Try

string query = "SELECT [Order ID], [Customer] FROM Orders";
SqlCeConnection conn = new SqlCeConnection(connString);
SqlCeCommand cmd = new SqlCeCommand(query, conn);

conn.Open();
SqlCeDataReader rdr = cmd.ExecuteReader();

try
{
    // Iterate through the results
    //
    while (rdr.Read())
    {
        int val1 = rdr.GetInt32(0);
        string val2 = rdr.GetString(1);
    }
}
finally
{
    // Always call Close when done reading
    //
    rdr.Close();

    // Always call Close when done reading
    //
    conn.Close();
}

스레드 보안

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

참고 항목

참조

System.Data.SqlServerCe 네임스페이스

SqlCeDataAdapter

SqlCeConnection