SqlCeCommand.CommandText Property
데이터 원본을 실행할 SQL 문을 가져오거나 설정합니다.
네임스페이스: System.Data.SqlServerCe
어셈블리: System.Data.SqlServerCe(system.data.sqlserverce.dll에 있음)
구문
‘선언
Public Overrides Property CommandText As String
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 Compact 3.5에서 데이터를 검색하는 가장 빠른 방법입니다. 명명된 테이블에 특수 문자가 포함되어 있으면 이스케이프 문자 구문을 사용해야 할 수도 있습니다. Execute 메서드 중 하나를 호출하면 명명된 테이블의 행과 열이 모두 반환됩니다.
현재 연결이 실행이나 페치(fetch) 작업을 수행하는 중이면 Connection, CommandType 및 CommandText 속성을 설정할 수 없습니다.
.NET Compact Framework Data Provider for SQL Server Compact 3.5에서는 CommandType이 Text로 설정된 경우 SqlCeCommand가 호출하는 SQL 문에 매개 변수를 전달하는 명명된 매개 변수를 지원합니다. 예를 들면 다음과 같습니다.
SELECT * FROM Customers WHERE CustomerID = @customerID
Data Provider for SQL Server Compact 3.5에서는 일괄 쿼리를 지원하지 않습니다. 명령은 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;
스레드 보안
이 유형의 모든 public static(Microsoft Visual Basic의 경우 공유) 멤버는 스레드로부터 안전합니다. 인스턴스 멤버는 스레드로부터의 안전성이 보장되지 않습니다.
플랫폼
개발 플랫폼
Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
버전 정보
.NET Framework 및 NET Compact Framework
3.5에서 지원됨
.NET Framework
3.0에서 지원됨
.NET Compact Framework 및 .Net Framework
2.0에서 지원됨
참고 항목
참조
SqlCeCommand Class
SqlCeCommand Members
System.Data.SqlServerCe Namespace
Connection
CommandType