SqlCommand Constructores

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

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 .

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 .

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.

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.

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.