Compartir a través de


SqlCommand Constructores

Definición

Sobrecargas

SqlCommand()

Inicializa una nueva instancia de la clase SqlCommand.

SqlCommand(String)

Inicializa una nueva instancia de la clase SqlCommand con el texto de la consulta.

SqlCommand(String, SqlConnection)

Inicializa una nueva instancia de la SqlCommand clase con el texto de la consulta y un .SqlConnection

SqlCommand(String, SqlConnection, SqlTransaction)

Inicializa una nueva instancia de la SqlCommand clase con el texto de la consulta, un SqlConnection y .SqlTransaction

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

Inicializa una nueva instancia de la clase SqlCommand con texto de comando especificado, conexión, transacción y configuración de cifrado.

SqlCommand()

Inicializa una nueva instancia de la clase SqlCommand.

public:
 SqlCommand();
public SqlCommand ();
Public Sub New ()

Ejemplos

En el ejemplo siguiente se crea y SqlCommand se establece la CommandTimeout propiedad .

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

Comentarios

El constructor base inicializa todos los campos en sus valores predeterminados. En la tabla siguiente se muestran los valores de propiedad iniciales de una instancia de SqlCommand.

Propiedades Valor inicial
CommandText cadena vacía ("")
CommandTimeout 30
CommandType CommandType.Text
Connection Null

Puede cambiar el valor de cualquiera de estas propiedades a través de una llamada independiente a la propiedad .

Se aplica a

SqlCommand(String)

Inicializa una nueva instancia de la clase SqlCommand con el texto de la consulta.

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)

Parámetros

cmdText
String

Texto de la consulta.

Ejemplos

En el ejemplo siguiente se crea , SqlCommandpasando la cadena de conexión y el texto 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;
    }

Comentarios

Cuando se crea una instancia de , las siguientes propiedades de SqlCommand lectura y escritura se establecen en valores iniciales.

Propiedades Valor inicial
CommandText cmdText
CommandTimeout 30
CommandType CommandType.Text
Connection null

Puede cambiar el valor de cualquiera de estas propiedades a través de una llamada independiente a la propiedad .

Se aplica a

SqlCommand(String, SqlConnection)

Inicializa una nueva instancia de la SqlCommand clase con el texto de la consulta y un .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)

Parámetros

cmdText
String

Texto de la consulta.

connection
SqlConnection

SqlConnection que representa la conexión a una instancia de SQL Server.

Ejemplos

En el ejemplo siguiente se crea y SqlCommand se establecen algunas de sus propiedades.

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

Comentarios

En la tabla siguiente se muestran los valores de propiedad iniciales de una instancia de SqlCommand.

Propiedades Valor inicial
CommandText cmdText
CommandTimeout 30
CommandType CommandType.Text
Connection Nuevo SqlConnection que es el valor del connection parámetro .

Puede cambiar el valor de cualquiera de estos parámetros estableciendo la propiedad relacionada.

Se aplica a

SqlCommand(String, SqlConnection, SqlTransaction)

Inicializa una nueva instancia de la SqlCommand clase con el texto de la consulta, un SqlConnection y .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)

Parámetros

cmdText
String

Texto de la consulta.

connection
SqlConnection

SqlConnection que representa la conexión a una instancia de SQL Server.

transaction
SqlTransaction

SqlTransaction donde se ejecuta SqlCommand.

Comentarios

En la tabla siguiente se muestran los valores de propiedad iniciales de una instancia de SqlCommand.

Propiedades Valor inicial
CommandText cmdText
CommandTimeout 30
CommandType CommandType.Text
Connection Nuevo SqlConnection que es el valor del connection parámetro .

Puede cambiar el valor de cualquiera de estos parámetros estableciendo la propiedad relacionada.

Se aplica a

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

Inicializa una nueva instancia de la clase SqlCommand con texto de comando especificado, conexión, transacción y configuración de cifrado.

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)

Parámetros

cmdText
String

Texto de la consulta.

connection
SqlConnection

SqlConnection que representa la conexión a una instancia de SQL Server.

transaction
SqlTransaction

SqlTransaction donde se ejecuta SqlCommand.

columnEncryptionSetting
SqlCommandColumnEncryptionSetting

Configuración de cifrado. Para obtener más información, vea Always Encrypted.

Se aplica a