SqlCommand Costruttori

Definizione

Spazio dei nomi:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacchetto:

Microsoft.Data.SqlClient v5.2.0

Overload

SqlCommand()	Inizializza una nuova istanza della classe SqlCommand.
SqlCommand(String)	Inizializza una nuova istanza della classe SqlCommand con il testo della query.
SqlCommand(String, SqlConnection)	Inizializza una nuova istanza della SqlCommand classe con il testo della query e un oggetto SqlConnection .
SqlCommand(String, SqlConnection, SqlTransaction)	Inizializza una nuova istanza della SqlCommand classe con il testo della query, un SqlConnection oggetto e .SqlTransaction
SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)	Inizializza una nuova istanza della classe SqlCommand con l'impostazione specificata per il testo del comando, la connessione, la transazione e la crittografia.

SqlCommand()

Inizializza una nuova istanza della classe SqlCommand.

public:
 SqlCommand();

public SqlCommand ();

Public Sub New ()

Esempio

Nell'esempio seguente viene creato un oggetto SqlCommand e viene impostata la CommandTimeout proprietà .

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

Commenti

Il costruttore di base inizializza tutti i campi nei valori predefiniti. Nella tabella seguente vengono illustrati i valori iniziali delle proprietà per un'istanza di SqlCommand.

Proprietà	Valore iniziale
CommandText	stringa vuota ("")
CommandTimeout	30
CommandType	CommandType.Text
Connection	Null

È possibile modificare il valore di una di queste proprietà tramite una chiamata separata alla proprietà .

SqlCommand(String)

Inizializza una nuova istanza della classe SqlCommand con il testo della query.

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)

Parametri

cmdText

String

Testo della query.

Esempio

Nell'esempio seguente viene creato un SqlCommandoggetto , passando la stringa di connessione e il testo del comando.

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

Commenti

Quando viene creata un'istanza di , le proprietà di SqlCommand lettura/scrittura seguenti vengono impostate sui valori iniziali.

Proprietà	Valore iniziale
CommandText	cmdText
CommandTimeout	30
CommandType	CommandType.Text
Connection	Null

È possibile modificare il valore di una di queste proprietà tramite una chiamata separata alla proprietà .

SqlCommand(String, SqlConnection)

Inizializza una nuova istanza della SqlCommand classe con il testo della query e un oggetto 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)

Parametri

cmdText

String

Testo della query.

connection

SqlConnection

Oggetto SqlConnection che rappresenta la connessione a un'istanza di SQL Server.

Esempio

Nell'esempio seguente viene creato un oggetto SqlCommand e vengono impostate alcune delle relative proprietà.

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

Commenti

Nella tabella seguente vengono illustrati i valori iniziali delle proprietà per un'istanza di SqlCommand.

Proprietà	Valore iniziale
CommandText	cmdText
CommandTimeout	30
CommandType	CommandType.Text
Connection	Nuovo SqlConnection oggetto che rappresenta il valore per il connection parametro .

È possibile modificare il valore per uno di questi parametri impostando la proprietà correlata.

SqlCommand(String, SqlConnection, SqlTransaction)

Inizializza una nuova istanza della SqlCommand classe con il testo della query, un SqlConnection oggetto e .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)

Parametri

cmdText

String

Testo della query.

connection

SqlConnection

Oggetto SqlConnection che rappresenta la connessione a un'istanza di SQL Server.

transaction

SqlTransaction

Oggetto SqlTransaction in cui viene eseguito l'oggetto SqlCommand.

Commenti

Nella tabella seguente vengono illustrati i valori iniziali delle proprietà per un'istanza di SqlCommand.

Proprietà	Valore iniziale
CommandText	cmdText
CommandTimeout	30
CommandType	CommandType.Text
Connection	Nuovo SqlConnection oggetto che rappresenta il valore per il connection parametro .

È possibile modificare il valore per uno di questi parametri impostando la proprietà correlata.

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

Inizializza una nuova istanza della classe SqlCommand con l'impostazione specificata per il testo del comando, la connessione, la transazione e la crittografia.

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)

Parametri

cmdText

String

Testo della query.

connection

SqlConnection

Oggetto SqlConnection che rappresenta la connessione a un'istanza di SQL Server.

transaction

SqlTransaction

Oggetto SqlTransaction in cui viene eseguito l'oggetto SqlCommand.

columnEncryptionSetting

SqlCommandColumnEncryptionSetting

Impostazione di crittografia. Per altre informazioni, vedere Always Encrypted.