SqlCommand Costruttori

Definizione

Spazio dei nomi:: Microsoft.Data.SqlClient

Assembly:: Microsoft.Data.SqlClient.dll

Pacchetto:: Microsoft.Data.SqlClient v1.0.19269.1

Pacchetto:: Microsoft.Data.SqlClient v1.1.4

Pacchetto:: Microsoft.Data.SqlClient v2.0.1

Pacchetto:: Microsoft.Data.SqlClient v2.1.4

Pacchetto:: Microsoft.Data.SqlClient v3.0.1

Pacchetto:: Microsoft.Data.SqlClient v3.1.0

Pacchetto:: Microsoft.Data.SqlClient v4.0.1

Pacchetto:: Microsoft.Data.SqlClient v4.1.0

Pacchetto:: Microsoft.Data.SqlClient v5.0.0

Pacchetto:: Microsoft.Data.SqlClient v5.1.0

Pacchetto:: Microsoft.Data.SqlClient v5.2.0

Pacchetto:: Microsoft.Data.SqlClient v6.0.2

Pacchetto:: Microsoft.Data.SqlClient v6.1.3

Pacchetto:: Microsoft.Data.SqlClient v7.0.1

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Overload

Nome	Descrizione
SqlCommand()	Inizializza una nuova istanza della classe SqlCommand.
SqlCommand(String)	Inizializza una nuova istanza della SqlCommand classe 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 SqlConnectionoggetto e .SqlTransaction
SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)	Inizializza una nuova istanza della SqlCommand classe con testo del comando, connessione, transazione e impostazione di crittografia specificati.

SqlCommand()

Origine:: SqlCommand.cs

Origine:: SqlCommand.cs

Origine:: SqlCommand.cs

Origine:: SqlCommand.cs

Inizializza una nuova istanza della classe SqlCommand.

public:
 SqlCommand();

public SqlCommand();

Public Sub New ()

Esempio

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

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

Commenti

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

Properties	Valore iniziale
CommandText	stringa vuota ("")
CommandTimeout	30
CommandType	Text
Connection	`null`

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

Si applica a

SqlCommand(String)

Origine:: SqlCommand.cs

Origine:: SqlCommand.cs

Origine:: SqlCommand.cs

Origine:: SqlCommand.cs

Inizializza una nuova istanza della SqlCommand classe 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 il testo del comando.

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

Commenti

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

Properties	Valore iniziale
CommandText	`cmdText`
CommandTimeout	30
CommandType	Text
Connection	`null`

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

Si applica a

SqlCommand(String, SqlConnection)

Origine:: SqlCommand.cs

Origine:: SqlCommand.cs

Origine:: SqlCommand.cs

Origine:: SqlCommand.cs

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 SqlCommand oggetto 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.

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

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

Si applica a

SqlCommand(String, SqlConnection, SqlTransaction)

Origine:: SqlCommand.cs

Origine:: SqlCommand.cs

Origine:: SqlCommand.cs

Origine:: SqlCommand.cs

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

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

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

Si applica a

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

Origine:: SqlCommand.cs

Origine:: SqlCommand.cs

Origine:: SqlCommand.cs

Origine:: SqlCommand.cs

Inizializza una nuova istanza della SqlCommand classe con testo del comando, connessione, transazione e impostazione di crittografia specificati.

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.

Si applica a