다음을 통해 공유


SqlCommand 생성자

정의

오버로드

SqlCommand()

SqlCommand 클래스의 새 인스턴스를 초기화합니다.

SqlCommand(String)

쿼리 텍스트를 사용하여 SqlCommand 클래스의 새 인스턴스를 초기화합니다.

SqlCommand(String, SqlConnection)

쿼리의 텍스트와 를 사용하여 클래스의 새 인스턴스 SqlCommandSqlConnection 초기화합니다.

SqlCommand(String, SqlConnection, SqlTransaction)

쿼리, 및 SqlTransactionSqlCommand 텍스트를 사용하여 클래스의 새 인스턴스를 SqlConnection 초기화합니다.

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

지정된 명령 텍스트, 연결, 트랜잭션 및 암호화 설정을 사용하여 SqlCommand 클래스의 새 인스턴스를 초기화합니다.

SqlCommand()

SqlCommand 클래스의 새 인스턴스를 초기화합니다.

public:
 SqlCommand();
public SqlCommand ();
Public Sub New ()

예제

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

// <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 CreateSqlCommand()
    {
        SqlCommand command = new SqlCommand();
        command.CommandTimeout = 15;
        command.CommandType = CommandType.Text;
    }
    // </Snippet1>
}

설명

기본 생성자는 모든 필드를 기본값으로 초기화합니다. 다음 표에서 인스턴스에 대 한 초기 속성 값을 보여 줍니다. SqlCommand합니다.

속성 초기 값
CommandText 빈 문자열("")
CommandTimeout 30
CommandType CommandType.Text
Connection Null

속성에 별도 호출을 통해 이러한 속성의 값을 변경할 수 있습니다.

적용 대상

SqlCommand(String)

쿼리 텍스트를 사용하여 SqlCommand 클래스의 새 인스턴스를 초기화합니다.

public:
 SqlCommand(System::String ^ cmdText);
public SqlCommand (string cmdText);
new Microsoft.Data.SqlClient.SqlCommand : string -> Microsoft.Data.SqlClient.SqlCommand
Public Sub New (cmdText As String)

매개 변수

cmdText
String

쿼리 텍스트입니다.

예제

다음 예제에서는 연결 문자열 및 명령 텍스트를 전달하는 를 만듭니다 SqlCommand.

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()
    {
        string queryString = "SELECT * FROM Categories ORDER BY CategoryID";
        SqlCommand command = new SqlCommand(queryString);
        command.CommandTimeout = 15;
        command.CommandType = CommandType.Text;
    }

설명

인스턴스 SqlCommand 가 만들어지면 다음 읽기/쓰기 속성이 초기 값으로 설정됩니다.

속성 초기 값
CommandText cmdText
CommandTimeout 30
CommandType CommandType.Text
Connection null

속성에 별도 호출을 통해 이러한 속성의 값을 변경할 수 있습니다.

적용 대상

SqlCommand(String, SqlConnection)

쿼리의 텍스트와 를 사용하여 클래스의 새 인스턴스 SqlCommandSqlConnection 초기화합니다.

public:
 SqlCommand(System::String ^ cmdText, Microsoft::Data::SqlClient::SqlConnection ^ connection);
public SqlCommand (string cmdText, Microsoft.Data.SqlClient.SqlConnection connection);
new Microsoft.Data.SqlClient.SqlCommand : string * Microsoft.Data.SqlClient.SqlConnection -> Microsoft.Data.SqlClient.SqlCommand
Public Sub New (cmdText As String, connection As SqlConnection)

매개 변수

cmdText
String

쿼리 텍스트입니다.

connection
SqlConnection

SQL Server의 인스턴스에 대한 연결을 나타내는 SqlConnection입니다.

예제

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

using System;
using System.Data;
using Microsoft.Data.SqlClient;


namespace SqlCommandCS
{
    class Program
    {
        static void Main()
        {
            string str = "Data Source=(local);Initial Catalog=Northwind;"
                + "Integrated Security=SSPI";
            string qs = "SELECT OrderID, CustomerID FROM dbo.Orders;";
            CreateCommand(qs, str);

        }

        private static void CreateCommand(string queryString,
            string connectionString)
        {
            using (SqlConnection connection = new SqlConnection(
                       connectionString))
            {
                SqlCommand command = new SqlCommand(
                    queryString, connection);
                connection.Open();
                SqlDataReader reader = command.ExecuteReader();
                while (reader.Read())
                {
                    Console.WriteLine(String.Format("{0}, {1}",
                        reader[0], reader[1]));
                }
            }
        }

설명

다음 표에서 인스턴스에 대 한 초기 속성 값을 보여 줍니다. SqlCommand합니다.

속성 초기 값
CommandText cmdText
CommandTimeout 30
CommandType CommandType.Text
Connection 매개 변수의 값인 새 SqlConnection 입니다 connection .

관련 속성을 설정하여 이러한 매개 변수의 값을 변경할 수 있습니다.

적용 대상

SqlCommand(String, SqlConnection, SqlTransaction)

쿼리, 및 SqlTransactionSqlCommand 텍스트를 사용하여 클래스의 새 인스턴스를 SqlConnection 초기화합니다.

public:
 SqlCommand(System::String ^ cmdText, Microsoft::Data::SqlClient::SqlConnection ^ connection, Microsoft::Data::SqlClient::SqlTransaction ^ transaction);
public SqlCommand (string cmdText, Microsoft.Data.SqlClient.SqlConnection connection, Microsoft.Data.SqlClient.SqlTransaction transaction);
new Microsoft.Data.SqlClient.SqlCommand : string * Microsoft.Data.SqlClient.SqlConnection * Microsoft.Data.SqlClient.SqlTransaction -> Microsoft.Data.SqlClient.SqlCommand
Public Sub New (cmdText As String, connection As SqlConnection, transaction As SqlTransaction)

매개 변수

cmdText
String

쿼리 텍스트입니다.

connection
SqlConnection

SQL Server의 인스턴스에 대한 연결을 나타내는 SqlConnection입니다.

transaction
SqlTransaction

SqlCommand가 실행되는 SqlTransaction입니다.

설명

다음 표에서 인스턴스에 대 한 초기 속성 값을 보여 줍니다. SqlCommand합니다.

속성 초기 값
CommandText cmdText
CommandTimeout 30
CommandType CommandType.Text
Connection 매개 변수의 값인 새 SqlConnection 입니다 connection .

관련 속성을 설정하여 이러한 매개 변수의 값을 변경할 수 있습니다.

적용 대상

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

지정된 명령 텍스트, 연결, 트랜잭션 및 암호화 설정을 사용하여 SqlCommand 클래스의 새 인스턴스를 초기화합니다.

public:
 SqlCommand(System::String ^ cmdText, Microsoft::Data::SqlClient::SqlConnection ^ connection, Microsoft::Data::SqlClient::SqlTransaction ^ transaction, Microsoft::Data::SqlClient::SqlCommandColumnEncryptionSetting columnEncryptionSetting);
public SqlCommand (string cmdText, Microsoft.Data.SqlClient.SqlConnection connection, Microsoft.Data.SqlClient.SqlTransaction transaction, Microsoft.Data.SqlClient.SqlCommandColumnEncryptionSetting columnEncryptionSetting);
new Microsoft.Data.SqlClient.SqlCommand : string * Microsoft.Data.SqlClient.SqlConnection * Microsoft.Data.SqlClient.SqlTransaction * Microsoft.Data.SqlClient.SqlCommandColumnEncryptionSetting -> Microsoft.Data.SqlClient.SqlCommand
Public Sub New (cmdText As String, connection As SqlConnection, transaction As SqlTransaction, columnEncryptionSetting As SqlCommandColumnEncryptionSetting)

매개 변수

cmdText
String

쿼리 텍스트입니다.

connection
SqlConnection

SQL Server의 인스턴스에 대한 연결을 나타내는 SqlConnection입니다.

transaction
SqlTransaction

SqlCommand가 실행되는 SqlTransaction입니다.

columnEncryptionSetting
SqlCommandColumnEncryptionSetting

암호화 설정입니다. 자세한 내용은 Always Encrypted를 참조하세요.

적용 대상