SqlCeCommand.CommandText 속성
데이터 원본을 실행할 SQL 문을 가져오거나 설정합니다.
네임스페이스: System.Data.SqlServerCe
어셈블리: System.Data.SqlServerCe(System.Data.SqlServerCe.dll)
구문
‘선언
Public Overrides Property CommandText As String
Get
Set
‘사용 방법
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;
}
abstract CommandText : string with get, set
override CommandText : string with get, set
override function get CommandText () : String
override function set CommandText (value : String)
속성 값
유형: System.String
실행할 SQL 문이나 열어 놓을 기본 테이블의 이름입니다. 기본값은 빈 문자열입니다.
구현
주의
CommandType 속성을 TableDirect로 설정할 경우 CommandText 속성은 액세스할 테이블의 이름으로 설정해야 합니다. TableDirect 액세스는 SQL Server Compact에서 데이터를 검색하는 가장 빠른 방법입니다. 명명된 테이블에 특수 문자가 포함되어 있으면 이스케이프 문자 구문을 사용해야 할 수도 있습니다. Execute 메서드 중 하나를 호출하면 명명된 테이블의 행과 열이 모두 반환됩니다.
현재 연결이 실행이나 인출 작업을 수행하는 중이면 Connection, CommandType 및 CommandText 속성을 설정할 수 없습니다.
.NET Compact Framework Data Provider for SQL Server Compact에서는 CommandType이 Text로 설정된 경우 SqlCeCommand가 호출하는 SQL 문에 매개 변수를 전달하는 명명된 매개 변수를 지원합니다. 예를 들면 다음과 같습니다.
SELECT * FROM Customers WHERE CustomerID = @customerID
Data Provider for SQL Server Compact에서는 일괄 쿼리를 지원하지 않습니다. 명령은 SELECT * FROM Customers; SELECT * FROM Orders가 아니라 SELECT * FROM Customers 형식을 따라야 합니다. System.Data.SqlClient에서 생성된 코드를 사용하는 경우 이 제한을 따르도록 쿼리를 수정해야 할 수도 있습니다.
RDA 설정 복제를 사용할 경우 INSERT 쿼리의 열 이름을 지정합니다. RDA 추적 테이블에는 쿼리에서 예상한 열 수를 변경하는 시스템 생성 열이 포함됩니다. 열 이름을 지정하지 않았는데 INSERT 문의 열 수가 테이블의 열 수와 다르면 INSERT가 실패합니다.
예
다음 예제에서는 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;