SqlCommand SqlCommand SqlCommand SqlCommand Constructors

Definición

Sobrecargas

SqlCommand() SqlCommand() SqlCommand()

Inicializa una nueva instancia de la clase SqlCommand.Initializes a new instance of the SqlCommand class.

SqlCommand(String) SqlCommand(String) SqlCommand(String) SqlCommand(String)

Inicializa una nueva instancia de la clase SqlCommand con el texto de la consulta.Initializes a new instance of the SqlCommand class with the text of the query.

SqlCommand(String, SqlConnection) SqlCommand(String, SqlConnection) SqlCommand(String, SqlConnection) SqlCommand(String, SqlConnection)

Inicializa una nueva instancia de la clase SqlCommand con el texto de la consulta y una conexión SqlConnection.Initializes a new instance of the SqlCommand class with the text of the query and a SqlConnection.

SqlCommand(String, SqlConnection, SqlTransaction) SqlCommand(String, SqlConnection, SqlTransaction) SqlCommand(String, SqlConnection, SqlTransaction) 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.Initializes a new instance of the SqlCommand class with the text of the query, a SqlConnection, and the SqlTransaction.

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting) SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting) SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting) 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.Initializes a new instance of the SqlCommand class with specified command text, connection, transaction, and encryption setting.

SqlCommand() SqlCommand() SqlCommand()

Inicializa una nueva instancia de la clase SqlCommand.Initializes a new instance of the SqlCommand class.

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

Ejemplos

En el ejemplo siguiente se SqlCommand crea un y CommandTimeout se establece la propiedad.The following example creates a SqlCommand and sets the CommandTimeout property.

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 con sus valores predeterminados.The base constructor initializes all fields to their default values. En la tabla siguiente se muestran los valores de propiedad iniciales SqlCommandde una instancia de.The following table shows initial property values for an instance of SqlCommand.

PropiedadesProperties Valor inicialInitial value
CommandText Cadena vacía ("")empty string ("")
CommandTimeout 3030
CommandType CommandType.Text
Connection NullNull

Puede cambiar el valor de cualquiera de estas propiedades a través de una llamada independiente a la propiedad.You can change the value for any of these properties through a separate call to the property.

Consulte también:

SqlCommand(String) SqlCommand(String) SqlCommand(String) SqlCommand(String)

Inicializa una nueva instancia de la clase SqlCommand con el texto de la consulta.Initializes a new instance of the SqlCommand class with the text of the query.

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 String String String

Texto de la consulta.The text of the query.

Ejemplos

En el ejemplo siguiente se SqlCommandcrea un, pasando la cadena de conexión y el texto del comando.The following example creates a SqlCommand, passing in the connection string and command text.

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 SqlCommand instancia de, las siguientes propiedades de lectura y escritura se establecen en valores iniciales.When an instance of SqlCommand is created, the following read/write properties are set to initial values.

PropiedadesProperties Valor inicialInitial value
CommandText cmdText
CommandTimeout 3030
CommandType CommandType.Text
Connection nulonull

Puede cambiar el valor de cualquiera de estas propiedades a través de una llamada independiente a la propiedad.You can change the value for any of these properties through a separate call to the property.

Consulte también:

SqlCommand(String, SqlConnection) SqlCommand(String, SqlConnection) SqlCommand(String, SqlConnection) SqlCommand(String, SqlConnection)

Inicializa una nueva instancia de la clase SqlCommand con el texto de la consulta y una conexión SqlConnection.Initializes a new instance of the SqlCommand class with the text of the query and a 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 String String String

Texto de la consulta.The text of the query.

connection
SqlConnection SqlConnection SqlConnection SqlConnection

SqlConnection que representa la conexión a una instancia de SQL Server.A SqlConnection that represents the connection to an instance of SQL Server.

Ejemplos

En el ejemplo siguiente se SqlCommand crea un y se establecen algunas de sus propiedades.The following example creates a SqlCommand and sets some of its properties.

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 SqlCommandde una instancia de.The following table shows initial property values for an instance of SqlCommand.

PropiedadesProperties Valor inicialInitial value
CommandText cmdText
CommandTimeout 3030
CommandType CommandType.Text
Connection Nuevo SqlConnection que es el valor connection del parámetro.A new SqlConnection that is the value for the connection parameter.

Puede cambiar el valor de cualquiera de estos parámetros estableciendo la propiedad relacionada.You can change the value for any of these parameters by setting the related property.

Consulte también:

SqlCommand(String, SqlConnection, SqlTransaction) SqlCommand(String, SqlConnection, SqlTransaction) SqlCommand(String, SqlConnection, SqlTransaction) 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.Initializes a new instance of the SqlCommand class with the text of the query, a SqlConnection, and the 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 String String String

Texto de la consulta.The text of the query.

connection
SqlConnection SqlConnection SqlConnection SqlConnection

SqlConnection que representa la conexión a una instancia de SQL Server.A SqlConnection that represents the connection to an instance of SQL Server.

Comentarios

En la tabla siguiente se muestran los valores de propiedad iniciales SqlCommandde una instancia de.The following table shows initial property values for an instance of SqlCommand.

PropiedadesProperties Valor inicialInitial value
CommandText cmdText
CommandTimeout 3030
CommandType CommandType.Text
Connection Nuevo SqlConnection que es el valor connection del parámetro.A new SqlConnection that is the value for the connection parameter.

Puede cambiar el valor de cualquiera de estos parámetros estableciendo la propiedad relacionada.You can change the value for any of these parameters by setting the related property.

Consulte también:

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting) SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting) SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting) 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.Initializes a new instance of the SqlCommand class with specified command text, connection, transaction, and encryption setting.

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 String String String

Texto de la consulta.The text of the query.

connection
SqlConnection SqlConnection SqlConnection SqlConnection

SqlConnection que representa la conexión a una instancia de SQL Server.A SqlConnection that represents the connection to an instance of SQL Server.

columnEncryptionSetting
SqlCommandColumnEncryptionSetting SqlCommandColumnEncryptionSetting SqlCommandColumnEncryptionSetting SqlCommandColumnEncryptionSetting

Configuración de cifrado.The encryption setting. Para obtener más información, vea Always Encrypted.For more information, see Always Encrypted.

Se aplica a