SqlCeCommand.CommandText 속성

아티클
08/21/2007

데이터 소스를 실행할 SQL 문을 가져오거나 설정합니다.

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

구문

‘선언
Public Overrides Property CommandText As String
‘사용 방법
Dim instance As SqlCeCommand
Dim value As String

value = instance.CommandText

instance.CommandText = value

public override string CommandText { get; set; }

public:
virtual property String^ CommandText {
    String^ get () override;
    void set (String^ value) override;
}

/** @property */
public String get_CommandText ()

/** @property */
public void set_CommandText (String value)

public override function get CommandText () : String

public override function set CommandText (value : String)

속성 값

실행할 SQL 문이나 열어 놓을 기본 테이블의 이름입니다. 기본값은 빈 문자열입니다.

설명

CommandType 속성을 TableDirect로 설정하면 CommandText 속성은 액세스할 테이블의 이름으로 설정해야 합니다. TableDirect 액세스는 SQL Server Mobile에서 데이터를 검색하는 가장 빠른 방법입니다. 명명된 테이블에 특수 문자가 포함되어 있으면 이스케이프 문자 구문을 사용해야 할 수도 있습니다. Execute 메서드 중 하나를 호출하면 명명된 테이블의 행과 열이 모두 반환됩니다.

현재 연결이 실행이나 페치(fetch) 작업을 수행하는 중이면 Connection, CommandType 및 CommandText 속성을 설정할 수 없습니다.

CommandType이 Text로 설정된 경우 .NET Compact Framework Data Provider for SQL Server Mobile에서는 SqlCeCommand가 호출하는 SQL 문에 매개 변수를 전달하는 명명된 매개 변수를 지원합니다. 예를 들면 다음과 같습니다.

SELECT * FROM Customers WHERE CustomerID = @customerID

Data Provider for SQL Server Mobile에서는 일괄 쿼리도 지원하지 않습니다. 명령은 SELECT * FROM Customers; SELECT * FROM Orders 형식이 아니라 SELECT * FROM Customers 형식을 따라야 합니다. System.Data.SqlClient에서 생성된 코드를 사용하는 경우 이 제한을 따르도록 쿼리를 수정해야 할 수도 있습니다.

예제

다음 예제에서는 SqlCeCommand를 만들고 CommandText 및 기타 속성을 설정합니다.

Dim cmd As SqlCeCommand = conn.CreateCommand()
cmd.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
cmd.CommandType = CommandType.Text
cmd.UpdatedRowSource = UpdateRowSource.Both

SqlCeCommand cmd = conn.CreateCommand();
cmd.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
cmd.CommandType = CommandType.Text;
cmd.UpdatedRowSource = UpdateRowSource.Both;

.NET Framework 보안

직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 을(를) 참조하십시오.

플랫폼

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows XP Professional x64 Edition, Windows XP SP2

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Compact Framework

2.0, 1.0에서 지원

참고 항목

참조

SqlCeCommand 클래스
SqlCeCommand 멤버
System.Data.SqlServerCe 네임스페이스
Connection
IDbCommand.CommandType 속성

다음을 통해 공유