SqlCommand.Connection Propriedade

Definição

Namespace:

System.Data.SqlClient

Assembly:

System.Data.dll

Obtém ou define o SqlConnection usado por essa instância do SqlCommand.

public:
 property System::Data::SqlClient::SqlConnection ^ Connection { System::Data::SqlClient::SqlConnection ^ get(); void set(System::Data::SqlClient::SqlConnection ^ value); };

public System.Data.SqlClient.SqlConnection Connection { get; set; }

member this.Connection : System.Data.SqlClient.SqlConnection with get, set

Public Property Connection As SqlConnection

Valor da propriedade

SqlConnection

A conexão com uma fonte de dados. O valor padrão é null.

Exceções

InvalidOperationException

A propriedade Connection foi alterada enquanto o comando foi inscrito em uma transação.

Exemplos

O exemplo a seguir cria um SqlCommand e define algumas de suas propriedades.

private static void CreateCommand(string queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand();
        command.Connection = connection;
        command.CommandTimeout = 15;
        command.CommandType = CommandType.Text;
        command.CommandText = queryString;

        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()
        command.Connection = connection
        command.CommandTimeout = 15
        command.CommandType = CommandType.Text
        command.CommandText = queryString

        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

Comentários

Se o comando estiver inscrito em uma transação existente e a conexão for alterada, tentar executar o comando gerará um InvalidOperationException.

Se a Transaction propriedade não for nula e a transação já tiver sido confirmada ou revertida, Transaction será definida como nula.

Confira também

• CommandText
• CommandTimeout
• CommandType
• Visão geral do ADO.NET