SqlCommand.CommandText 속성

정의

네임스페이스:

Microsoft.Data.SqlClient

어셈블리:

Microsoft.Data.SqlClient.dll

패키지:

Microsoft.Data.SqlClient v5.2.0

데이터 소스에서 실행할 Transact-SQL 문, 테이블 이름 또는 저장 프로시저를 가져오거나 설정합니다.

public:
 virtual property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };

public override string CommandText { get; set; }

member this.CommandText : string with get, set

Public Overrides Property CommandText As String

속성 값

String

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

예제

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

// <Snippet1>
using System;
using System.Xml;
using System.Data;
using Microsoft.Data.SqlClient;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet DataSet1;
    protected DataGrid dataGrid1;

    public void CreateCommand()
    {
        SqlCommand command = new SqlCommand();
        command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
        command.CommandTimeout = 15;
        command.CommandType = CommandType.Text;
    }
    // </Snippet1>

}

설명

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

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

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

자세한 내용은 매개 변수 구성을 참조하세요.