OleDbCommand.CommandText 속성

정의

SQL 문이나 데이터 소스에서 실행할 저장 프로시저를 가져오거나 설정합니다.

public:
 virtual property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
public:
 property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
public override string CommandText { get; set; }
[System.Data.DataSysDescription("DbCommand_CommandText")]
public string CommandText { get; set; }
member this.CommandText : string with get, set
[<System.Data.DataSysDescription("DbCommand_CommandText")>]
member this.CommandText : string with get, set
Public Overrides Property CommandText As String
Public Property CommandText As String

속성 값

실행할 SQL 문 또는 저장 프로시저입니다. 기본값은 빈 문자열입니다.

구현

특성

예제

다음 예제에서는 를 만들고 OleDbCommand 해당 속성 중 일부를 설정합니다.

public void CreateMyOleDbCommand()
{
   OleDbCommand command = new OleDbCommand();
   command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
   command.CommandTimeout = 20;
}
Public Sub CreateMyOleDbCommand()
    Dim command As New OleDbCommand()
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
    command.CommandTimeout = 20
End Sub

설명

속성이 로 CommandTypeCommandType 설정StoredProcedure되면 속성을 저장 프로시저의 이름으로 설정해야 합니다. 저장 프로시저 이름에 특수 문자가 포함된 경우 사용자는 이스케이프 문자 구문을 사용해야 할 수 있습니다. 명령은 메서드 중 하나를 호출할 때 이 저장 프로시저를 Execute 실행합니다.

가 로 설정된 경우 CommandType 속성은 CommandType 액세스할 테이블 또는 테이블의 이름으로 설정해야 TableDirect합니다. 명명된 테이블에 특수 문자가 포함된 경우 사용자는 이스케이프 문자 구문을 사용해야 할 수 있습니다. 명명된 테이블 또는 테이블의 모든 행과 열은 메서드 중 Execute 하나를 호출할 때 반환됩니다.

현재 연결이 Connection실행 또는 페치 작업을 수행하는 경우 , CommandTypeCommandText 속성을 설정할 수 없습니다.

OLE DB.NET 공급자는 가 로 설정된 경우 CommandType 에서 호출하는 SQL 문 또는 저장 프로시저에 매개 변수를 전달하기 위한 명명된 매개 변수를 OleDbCommandText지원하지 않습니다. 이 경우 물음표(?) 자리 표시자를 사용해야 합니다. 예를 들면 다음과 같습니다.

SELECT * FROM Customers WHERE CustomerID = ?

따라서 개체가 에 추가 OleDbParameterCollection 되는 OleDbParameter 순서는 매개 변수에 대한 물음표 자리 표시자의 위치에 직접 해당해야 합니다.

자세한 내용은 매개 변수 및 매개 변수 데이터 형식 구성을 참조하세요.

적용 대상

추가 정보