SqlCommand Oluşturucular

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Aşırı Yüklemeler

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 metniyle SqlCommand sınıfının yeni bir örneğini başlatır, bir SqlConnection ve SqlTransaction .
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 .

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

Açıklamalar

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

Özellikler	İlk değer
CommandText	boş dize ("")
CommandTimeout	30
CommandType	CommandType.Text
Connection	Null

Özelliğine ayrı bir çağrı aracılığıyla 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, bağlantı dizesini ve komut metnini geçirerek bir SqlCommandoluşturur.

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

Açıklamalar

Örneği SqlCommand oluşturulduğunda, aşağıdaki okuma/yazma özellikleri başlangıç değerlerine ayarlanır.

Özellikler	İlk değer
CommandText	cmdText
CommandTimeout	30
CommandType	CommandType.Text
Connection	null

Özelliğine ayrı bir çağrı aracılığıyla 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

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

Örnekler

Aşağıdaki örnek bir SqlCommand oluşturur ve bazı özelliklerini 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, örneğinin ilk özellik değerleri gösterilmektedir SqlCommand.

Özellikler	İlk değer
CommandText	cmdText
CommandTimeout	30
CommandType	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 metniyle SqlCommand sınıfının yeni bir örneğini başlatır, bir SqlConnection ve 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)

Parametreler

cmdText

String

Sorgu metni.

connection

SqlConnection

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

transaction

SqlTransaction

yürütülür SqlTransactionSqlCommand .

Açıklamalar

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

Özellikler	İlk değer
CommandText	cmdText
CommandTimeout	30
CommandType	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

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

transaction

SqlTransaction

yürütülür SqlTransactionSqlCommand .

columnEncryptionSetting

SqlCommandColumnEncryptionSetting

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