SqlCommand Konstruktor

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Overload

SqlCommand()	Menginisialisasi instans baru kelas SqlCommand.
SqlCommand(String)	Menginisialisasi instans SqlCommand baru kelas dengan teks kueri.
SqlCommand(String, SqlConnection)	Menginisialisasi instans SqlCommand baru kelas dengan teks kueri dan SqlConnection .
SqlCommand(String, SqlConnection, SqlTransaction)	Menginisialisasi instans SqlCommand baru kelas dengan teks kueri, SqlConnection , dan SqlTransaction .
SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)	Menginisialisasi instans SqlCommand baru kelas dengan pengaturan teks perintah, koneksi, transaksi, dan enkripsi yang ditentukan.

SqlCommand()

Menginisialisasi instans baru kelas SqlCommand.

public:
 SqlCommand();

public SqlCommand ();

Public Sub New ()

Contoh

Contoh berikut membuat SqlCommand dan mengatur CommandTimeout properti .

// <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>
}

Keterangan

Konstruktor dasar menginisialisasi semua bidang ke nilai defaultnya. Tabel berikut ini memperlihatkan nilai properti awal untuk instans SqlCommand.

Properti	Nilai awal
CommandText	string kosong ("")
CommandTimeout	30
CommandType	CommandType.Text
Connection	Null

Anda dapat mengubah nilai untuk salah satu properti ini melalui panggilan terpisah ke properti .

SqlCommand(String)

Menginisialisasi instans SqlCommand baru kelas dengan teks kueri.

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)

Parameter

cmdText

String

Teks kueri.

Contoh

Contoh berikut membuat SqlCommand, meneruskan string koneksi dan teks perintah.

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;
    }

Keterangan

Saat instans SqlCommand dibuat, properti baca/tulis berikut diatur ke nilai awal.

Properti	Nilai awal
CommandText	cmdText
CommandTimeout	30
CommandType	CommandType.Text
Connection	null

Anda dapat mengubah nilai untuk salah satu properti ini melalui panggilan terpisah ke properti .

SqlCommand(String, SqlConnection)

Menginisialisasi instans SqlCommand baru kelas dengan teks kueri dan 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)

Parameter

cmdText

String

Teks kueri.

connection

SqlConnection

SqlConnection yang mewakili koneksi ke instans SQL Server.

Contoh

Contoh berikut membuat SqlCommand dan mengatur beberapa propertinya.

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]));
                }
            }
        }

Keterangan

Tabel berikut ini memperlihatkan nilai properti awal untuk instans SqlCommand.

Properti	Nilai awal
CommandText	cmdText
CommandTimeout	30
CommandType	CommandType.Text
Connection	SqlConnection Baru yang merupakan nilai untuk connection parameter .

Anda dapat mengubah nilai untuk salah satu parameter ini dengan mengatur properti terkait.

SqlCommand(String, SqlConnection, SqlTransaction)

Menginisialisasi instans SqlCommand baru kelas dengan teks kueri, SqlConnection , dan SqlTransaction .

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)

Parameter

cmdText

String

Teks kueri.

connection

SqlConnection

SqlConnection yang mewakili koneksi ke instans SQL Server.

transaction

SqlTransaction

SqlCommand tempat SqlTransaction eksekusi.

Keterangan

Tabel berikut ini memperlihatkan nilai properti awal untuk instans SqlCommand.

Properti	Nilai awal
CommandText	cmdText
CommandTimeout	30
CommandType	CommandType.Text
Connection	SqlConnection Baru yang merupakan nilai untuk connection parameter .

Anda dapat mengubah nilai untuk salah satu parameter ini dengan mengatur properti terkait.

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

Menginisialisasi instans SqlCommand baru kelas dengan pengaturan teks perintah, koneksi, transaksi, dan enkripsi yang ditentukan.

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)

Parameter

cmdText

String

Teks kueri.

connection

SqlConnection

SqlConnection yang mewakili koneksi ke instans SQL Server.

transaction

SqlTransaction

SqlCommand tempat SqlTransaction eksekusi.

columnEncryptionSetting

SqlCommandColumnEncryptionSetting

Pengaturan enkripsi. Untuk informasi selengkapnya, lihat Always Encrypted.