SqlCommand 생성자

참조

정의

네임스페이스:: Microsoft.Data.SqlClient

어셈블리:: Microsoft.Data.SqlClient.dll

패키지:: Microsoft.Data.SqlClient v1.0.19269.1

패키지:: Microsoft.Data.SqlClient v1.1.4

패키지:: Microsoft.Data.SqlClient v2.0.1

패키지:: Microsoft.Data.SqlClient v2.1.4

패키지:: Microsoft.Data.SqlClient v3.0.1

패키지:: Microsoft.Data.SqlClient v3.1.0

패키지:: Microsoft.Data.SqlClient v4.0.1

패키지:: Microsoft.Data.SqlClient v4.1.0

패키지:: Microsoft.Data.SqlClient v5.0.0

패키지:: Microsoft.Data.SqlClient v5.1.0

패키지:: Microsoft.Data.SqlClient v5.2.0

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

오버로드

SqlCommand()	SqlCommand 클래스의 새 인스턴스를 초기화합니다.
SqlCommand(String)	쿼리 텍스트를 사용하여 SqlCommand 클래스의 새 인스턴스를 초기화합니다.
SqlCommand(String, SqlConnection)	쿼리의 텍스트와 를 사용하여 클래스의 새 인스턴스 SqlCommand 를 SqlConnection 초기화합니다.
SqlCommand(String, SqlConnection, SqlTransaction)	쿼리, 및 SqlTransaction 의 SqlCommand 텍스트를 사용하여 클래스의 새 인스턴스를 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)

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

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)

쿼리, 및 SqlTransaction 의 SqlCommand 텍스트를 사용하여 클래스의 새 인스턴스를 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를 참조하세요.

적용 대상

다음을 통해 공유

SqlCommand 생성자

정의

오버로드

SqlCommand()

예제

설명

적용 대상

SqlCommand(String)

매개 변수

예제

설명

적용 대상

SqlCommand(String, SqlConnection)

매개 변수

예제

설명

적용 대상

SqlCommand(String, SqlConnection, SqlTransaction)

매개 변수

설명

적용 대상

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

매개 변수

적용 대상

추가 리소스