SqlCommand Constructores

Referencia

Definición

Espacio de nombres:: System.Data.SqlClient

Ensamblado:: System.Data.SqlClient.dll

Ensamblado:: System.Data.dll

Paquete:: System.Data.SqlClient v4.8.6

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Inicializa una nueva instancia de la clase SqlCommand.

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 clase SqlCommand con el texto de la consulta y una conexión SqlConnection.
SqlCommand(String, SqlConnection, SqlTransaction)	Inicializa una nueva instancia de la clase SqlCommand con el texto de la consulta, un objeto SqlConnection y el objeto 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 .

public void CreateSqlCommand()
{
   SqlCommand command = new SqlCommand();
   command.CommandTimeout = 15;
   command.CommandType = CommandType.Text;
}

Public Sub CreateSqlCommand()
    Dim command As New SqlCommand()
    command.CommandTimeout = 15
    command.CommandType = CommandType.Text
End Sub

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 .

Consulte también

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 System.Data.SqlClient.SqlCommand : string -> System.Data.SqlClient.SqlCommand

Public Sub New (cmdText As String)

Parámetros

cmdText: String

Texto de la consulta.

Ejemplos

En el ejemplo siguiente se crea un SqlCommandobjeto , pasando el texto del comando y el cadena de conexión.

public void CreateCommand()
 {
    string queryString = "SELECT * FROM Categories ORDER BY CategoryID";
    SqlCommand command = new SqlCommand(queryString);
    command.CommandTimeout = 15;
    command.CommandType = CommandType.Text;
 }

Public Sub CreateCommand()
    Dim queryString As String = "SELECT * FROM Categories ORDER BY CategoryID"
    Dim command As New SqlCommand(queryString)
    command.CommandTimeout = 15
    command.CommandType = CommandType.Text
End Sub

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 .

Consulte también

Se aplica a

SqlCommand(String, SqlConnection)

Inicializa una nueva instancia de la clase SqlCommand con el texto de la consulta y una conexión SqlConnection.

public:
 SqlCommand(System::String ^ cmdText, System::Data::SqlClient::SqlConnection ^ connection);

public SqlCommand (string cmdText, System.Data.SqlClient.SqlConnection connection);

new System.Data.SqlClient.SqlCommand : string * System.Data.SqlClient.SqlConnection -> System.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.

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

Public Sub CreateCommand(ByVal queryString As String, _
  ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)

        connection.Open()
        Dim reader As SqlDataReader = command.ExecuteReader()
            While reader.Read()
            Console.WriteLine(String.Format("{0}, {1}", _
                reader(0), reader(1)))
        End While
    End Using
End Sub

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.

Consulte también

Se aplica a

SqlCommand(String, SqlConnection, SqlTransaction)

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

public:
 SqlCommand(System::String ^ cmdText, System::Data::SqlClient::SqlConnection ^ connection, System::Data::SqlClient::SqlTransaction ^ transaction);

public SqlCommand (string cmdText, System.Data.SqlClient.SqlConnection connection, System.Data.SqlClient.SqlTransaction transaction);

new System.Data.SqlClient.SqlCommand : string * System.Data.SqlClient.SqlConnection * System.Data.SqlClient.SqlTransaction -> System.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.

Consulte también

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, System::Data::SqlClient::SqlConnection ^ connection, System::Data::SqlClient::SqlTransaction ^ transaction, System::Data::SqlClient::SqlCommandColumnEncryptionSetting columnEncryptionSetting);

public SqlCommand (string cmdText, System.Data.SqlClient.SqlConnection connection, System.Data.SqlClient.SqlTransaction transaction, System.Data.SqlClient.SqlCommandColumnEncryptionSetting columnEncryptionSetting);

new System.Data.SqlClient.SqlCommand : string * System.Data.SqlClient.SqlConnection * System.Data.SqlClient.SqlTransaction * System.Data.SqlClient.SqlCommandColumnEncryptionSetting -> System.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

SqlCommand Constructores

Definición

Sobrecargas

SqlCommand()

Ejemplos

Comentarios

Consulte también

Se aplica a

SqlCommand(String)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

SqlCommand(String, SqlConnection)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

SqlCommand(String, SqlConnection, SqlTransaction)

Parámetros

Comentarios

Consulte también

Se aplica a

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

Parámetros

Se aplica a

Comentarios

Recursos adicionales