SqlCommand Oluşturucular

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v7.0.1

Aşırı Yüklemeler

Name	Description
SqlCommand()	SqlCommand sınıfının yeni bir örneğini başlatır.
SqlCommand(String)	Sorgu metniyle sınıfının yeni bir örneğini SqlCommand başlatır.
SqlCommand(String, SqlConnection)	sorgu metni SqlCommand ve ile sınıfının yeni bir SqlConnectionörneğini başlatır.
SqlCommand(String, SqlConnection, SqlTransaction)	sorgu metni SqlCommand , bir ve ile sınıfının yeni bir SqlConnectionörneğini SqlTransactionbaşlatır.
SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)	Belirtilen komut metni, bağlantı, işlem ve şifreleme ayarıyla sınıfın SqlCommand yeni bir örneğini başlatır.

SqlCommand()

SqlCommand sınıfının yeni bir örneğini başlatır.

public:
 SqlCommand();

public SqlCommand();

Public Sub New ()

Örnekler

Aşağıdaki örnek bir SqlCommand oluşturur ve özelliğini ayarlar CommandTimeout .

using System;
using System.Xml;
using System.Data;
using System.Data.Common;
using System.Windows.Forms;
using Microsoft.Data.SqlClient;

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

    public void CreateSqlCommand()
    {
        SqlCommand command = new SqlCommand();
        command.CommandTimeout = 15;
        command.CommandType = CommandType.Text;
    }
}

Açıklamalar

Temel oluşturucu tüm alanları varsayılan değerleriyle başlatır. Aşağıdaki tabloda, SqlCommandörneğinin ilk özellik değerleri gösterilmektedir.

Properties	İlk değer
CommandText	boş dize ("")
CommandTimeout	30
CommandType	Text
Connection	null

Özelliğine ayrı bir çağrı ile bu özelliklerden herhangi birinin değerini değiştirebilirsiniz.

SqlCommand(String)

Sorgu metniyle sınıfının yeni bir örneğini SqlCommand başlatır.

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)

Parametreler

cmdText

String

Sorgu metni.

Örnekler

Aşağıdaki örnek, komut metnini geçirerek bir SqlCommandoluşturur.

using System;
using System.Xml;
using System.Data;
using System.Data.Common;
using System.Windows.Forms;
using Microsoft.Data.SqlClient;

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

Açıklamalar

Örneği SqlCommand oluşturulduğunda, aşağıdaki okuma/yazma özellikleri ilk değerlere ayarlanır.

Properties	İlk değer
CommandText	cmdText
CommandTimeout	30
CommandType	Text
Connection	null

Özelliğine ayrı bir çağrı ile bu özelliklerden herhangi birinin değerini değiştirebilirsiniz.

SqlCommand(String, SqlConnection)

sorgu metni SqlCommand ve ile sınıfının yeni bir SqlConnectionörneğini başlatır.

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)

Parametreler

cmdText

String

Sorgu metni.

connection

SqlConnection

SQL Server örneğine bağlantıyı temsil eden bir SqlConnection.

Örnekler

Aşağıdaki örnek, bir SqlCommand oluşturur ve özelliklerinden bazılarını ayarlar.

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

Açıklamalar

Aşağıdaki tabloda, SqlCommandörneğinin ilk özellik değerleri gösterilmektedir.

Properties	İlk değer
CommandText	cmdText
CommandTimeout	30
CommandType	Text
Connection	parametresinin değeri olan yeni SqlConnection bir değer connection .

İlgili özelliği ayarlayarak bu parametrelerden herhangi birinin değerini değiştirebilirsiniz.

SqlCommand(String, SqlConnection, SqlTransaction)

sorgu metni SqlCommand , bir ve ile sınıfının yeni bir SqlConnectionörneğini SqlTransactionbaşlatır.

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)

Parametreler

cmdText

String

Sorgu metni.

connection

SqlConnection

SQL Server örneğine bağlantıyı temsil eden bir SqlConnection.

transaction

SqlTransaction

yürütülür SqlTransactionSqlCommand .

Açıklamalar

Aşağıdaki tabloda, SqlCommandörneğinin ilk özellik değerleri gösterilmektedir.

Properties	İlk değer
CommandText	cmdText
CommandTimeout	30
CommandType	Text
Connection	parametresinin değeri olan yeni SqlConnection bir değer connection .

İlgili özelliği ayarlayarak bu parametrelerden herhangi birinin değerini değiştirebilirsiniz.

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

Belirtilen komut metni, bağlantı, işlem ve şifreleme ayarıyla sınıfın SqlCommand yeni bir örneğini başlatır.

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)

Parametreler

cmdText

String

Sorgu metni.

connection

SqlConnection

SQL Server örneğine bağlantıyı temsil eden bir SqlConnection.

transaction

SqlTransaction

yürütülür SqlTransactionSqlCommand .

columnEncryptionSetting

SqlCommandColumnEncryptionSetting

Şifreleme ayarı. Daha fazla bilgi için bkz. Always Encrypted .