CommandText 속성(ADO)

공급자에 대해 실행될 명령의 텍스트를 나타냅니다.

설정 및 반환 값

SQL 문, 테이블 이름, 상대 URL 또는 저장 프로시저 호출과 같은 공급자 명령이 포함된 문자열 값을 가져오거나 설정합니다. 기본값은 빈 문자열("")입니다.

설명

CommandText 속성을 사용하여 Command 개체가 나타내는 명령의 텍스트를 설정하거나 반환합니다. 일반적으로는 SQL 문이지만 저장 프로시저 호출과 같이 공급자가 인식하는 다른 유형의 명령문일 수도 있습니다. SQL 문은 공급자의 쿼리 프로세서에서 지원하는 특정 언어 또는 버전이어야 합니다.

Command 개체의 Prepared 속성이 True로 설정되어 있고 CommandText 속성을 설정할 때 Command 개체가 열려 있는 연결에 바인딩된 경우 ADO는 Execute 또는 Open 메서드를 호출할 때 쿼리(즉, 공급자가 저장한 쿼리의 컴파일된 형식)를 준비합니다.

CommandType 속성 설정에 따라 ADO는 CommandText 속성을 변경할 수 있습니다. 언제든지 CommandText 속성을 읽어 ADO가 실행 중에 사용할 실제 명령 텍스트를 볼 수 있습니다.

CommandText 속성을 사용하여 파일 또는 디렉터리와 같은 리소스를 지정하는 상대 URL을 설정하거나 반환합니다. 리소스는 절대 URL로 명시적으로 지정된 위치 또는 열려 있는 Connection 개체에 의해 암시적으로 지정된 위치를 기준으로 합니다.

참고

http 체계를 사용하는 URL은 Microsoft OLE DB Provider for Internet Publishing을 자동으로 호출합니다. 자세한 내용은 절대 URL 및 상대 URL을 참조하세요.

적용 대상

명령 개체(ADO)

참고 항목

ActiveConnection, CommandText, CommandTimeout, CommandType, Size 및 Direction 속성 예제(VB)
ActiveConnection, CommandText, CommandTimeout, CommandType, Size 및 Direction 속성 예제(VC++)
Requery 메서드
ActiveConnection, CommandText, CommandTimeout, CommandType, Size 및 Direction 속성 예제(JScript)