SqlCommand.CommandText 속성

정의

데이터 소스에서 실행할 Transact-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

속성 값

실행할 Transact-SQL 문이나 저장 프로시저입니다. 기본값은 빈 문자열입니다.

구현

특성

예제

다음 예에서는 을 SqlCommand 만들고 일부 속성을 설정합니다.

public void CreateCommand()
 {
    SqlCommand command = new SqlCommand();
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
    command.CommandTimeout = 15;
    command.CommandType = CommandType.Text;
 }
Public Sub CreateCommand()
    Dim command As New SqlCommand()
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
    command.CommandTimeout = 15
    command.CommandType = CommandType.Text
End Sub

설명

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

SQL Server Microsoft .NET Framework 데이터 공급자는 매개 변수를 Transact-SQL 문 또는 명령CommandType.Text으로 호출된 저장 프로시저에 전달하는 물음표(?) 자리 표시자를 지원하지 않습니다. 이 경우 명명 된 매개 변수를 사용 합니다. 예를 들면 다음과 같습니다.

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

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

적용 대상

추가 정보