SqlCommand Construtores
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Inicializa uma nova instância da SqlCommand classe.
Sobrecargas
| Name | Description |
|---|---|
| SqlCommand() |
Inicializa uma nova instância da SqlCommand classe. |
| SqlCommand(String) |
Inicializa uma nova instância da SqlCommand classe com o texto da consulta. |
| SqlCommand(String, SqlConnection) |
Inicializa uma nova instância da SqlCommand classe com o texto da consulta e um SqlConnection. |
| SqlCommand(String, SqlConnection, SqlTransaction) |
Inicializa uma nova instância da SqlCommand classe com o texto da consulta, um SqlConnection, e o SqlTransaction. |
| SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting) |
Inicializa uma nova instância da SqlCommand classe com texto de comando especificado, ligação, transação e definição de encriptação. |
SqlCommand()
Inicializa uma nova instância da SqlCommand classe.
public:
SqlCommand();
public SqlCommand();
Public Sub New ()
Exemplos
O exemplo seguinte cria um SqlCommand e define a CommandTimeout propriedade.
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
Observações
O construtor base inicializa todos os campos aos seus valores padrão. A tabela seguinte mostra os valores iniciais das propriedades para uma instância de SqlCommand.
| Properties | Valor inicial |
|---|---|
| CommandText | corda vazia ("") |
| CommandTimeout | 30 |
| CommandType | CommandType.Text |
| Connection | Null |
Pode alterar o valor de qualquer uma destas propriedades através de uma chamada separada para a propriedade.
Ver também
Aplica-se a
SqlCommand(String)
Inicializa uma nova instância da SqlCommand classe com o texto da 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
O texto da consulta.
Exemplos
O exemplo seguinte cria um SqlCommand, passando o texto do comando.
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
Observações
Quando uma instância de SqlCommand é criada, as seguintes propriedades de leitura/escrita são definidas para valores iniciais.
| Properties | Valor inicial |
|---|---|
| CommandText | cmdText |
| CommandTimeout | 30 |
| CommandType | CommandType.Text |
| Connection | null |
Pode alterar o valor de qualquer uma destas propriedades através de uma chamada separada para a propriedade.
Ver também
- Ligar e Recuperar Dados em ADO.NET
- Usando o Data Provider do .NET Framework para SQL Server
- Visão geral ADO.NET
Aplica-se a
SqlCommand(String, SqlConnection)
Inicializa uma nova instância da SqlCommand classe com o texto da consulta e um 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
O texto da consulta.
- connection
- SqlConnection
Um SqlConnection que representa a ligação a uma instância de SQL Server.
Exemplos
O exemplo seguinte cria um SqlCommand e define algumas das suas propriedades.
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
Observações
A tabela seguinte mostra os valores iniciais das propriedades para uma instância de SqlCommand.
| Properties | Valor inicial |
|---|---|
| CommandText | cmdText |
| CommandTimeout | 30 |
| CommandType | CommandType.Text |
| Connection | Um novo SqlConnection é o valor do connection parâmetro. |
Pode alterar o valor de qualquer um destes parâmetros definindo a propriedade relacionada.
Ver também
- Ligar e Recuperar Dados em ADO.NET
- Usando o Data Provider do .NET Framework para SQL Server
- Visão geral ADO.NET
Aplica-se a
SqlCommand(String, SqlConnection, SqlTransaction)
Inicializa uma nova instância da SqlCommand classe com o texto da consulta, um SqlConnection, e o 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
O texto da consulta.
- connection
- SqlConnection
Um SqlConnection que representa a ligação a uma instância de SQL Server.
- transaction
- SqlTransaction
O SqlTransaction em que o SqlCommand executa.
Observações
A tabela seguinte mostra os valores iniciais das propriedades para uma instância de SqlCommand.
| Properties | Valor inicial |
|---|---|
| CommandText | cmdText |
| CommandTimeout | 30 |
| CommandType | CommandType.Text |
| Connection | Um novo SqlConnection é o valor do connection parâmetro. |
Pode alterar o valor de qualquer um destes parâmetros definindo a propriedade relacionada.
Ver também
- Ligar e Recuperar Dados em ADO.NET
- Usando o Data Provider do .NET Framework para SQL Server
- Visão geral ADO.NET
Aplica-se a
SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)
Inicializa uma nova instância da SqlCommand classe com texto de comando especificado, ligação, transação e definição de encriptação.
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
O texto da consulta.
- connection
- SqlConnection
Um SqlConnection que representa a ligação a uma instância de SQL Server.
- transaction
- SqlTransaction
O SqlTransaction em que o SqlCommand executa.
- columnEncryptionSetting
- SqlCommandColumnEncryptionSetting
A definição de encriptação. Para obter mais informações, consulte Sempre criptografado.