SqlCommand.Connection Propriété

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Obtient ou définit le SqlConnection utilisé par cette instance du SqlCommand .

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

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

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

Public Property Connection As SqlConnection

Valeur de propriété

SqlConnection

Connexion à une source de données. La valeur par défaut estnull .

Exceptions

InvalidOperationException

La propriété Connection a été changée pendant que la commande a été inscrite dans une transaction.

Exemples

L’exemple suivant crée un SqlCommand et définit certaines de ses propriétés.

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

Remarques

Si la commande est inscrite dans une transaction existante et que la connexion est modifiée, la tentative d’exécution de la commande lève un InvalidOperationException.

Si la propriété Transaction n’a pas la valeur null et si la transaction a déjà été validée ou restaurée, Transaction prend la valeur null.