Section courante

A propos

Section administrative du site

SqlConnection

 Connexion SQL
C# (C Sharp) System.Data.SqlClient

Description

Cette classe contient une représentation d'une connexion à une base de données SQL Server. Cette classe n'offre pas la possibilité d'être héritée.

Liste des méthodes

Méthode Prototype Description
SQLCONNECTION SqlConnection(); Ce constructeur permet d'effectuer l'initialisation d'une nouvelle instance de la classe SqlConnection avec les paramètres par défaut.
SQLCONNECTION SqlConnection(String); Ce constructeur permet d'effectuer l'initialisation d'une nouvelle instance de la classe SqlConnection en utilisant une chaîne de caractères de connexion (ConnectionString).
SQLCONNECTION SqlConnection(String, SqlCredential); Ce constructeur permet d'initialiser une nouvelle instance de la classe SqlConnection en utilisant une chaîne de caractères de connexion, mais sans utilisant Integrated Security = true et un objet SqlCredential contenant l'identificateur d'utilisateur et le mot de passe.
BEGINDBTRANSACTION BeginDbTransaction(IsolationLevel); Cette méthode permet de démarrer une transaction de base de données, laquelle est hérité de DbConnection.
BEGINDBTRANSACTIONASYNC BeginDbTransactionAsync(IsolationLevel, CancellationToken); Cette méthode permet de démarrer de manière désynchronisé une transaction de base de données, laquelle est hérité de DbConnection.
BEGINTRANSACTION BeginTransaction(); Cette méthode permet de démarrer une transaction de base de données.
BEGINTRANSACTION BeginTransaction(IsolationLevel); Cette méthode permet de démarrer une transaction de base de données avec le niveau d'isolation spécifié.
BEGINTRANSACTION BeginTransaction(IsolationLevel, String); Cette méthode permet de débuter une transaction de base de données avec le niveau d'isolement et le nom de transaction spécifiés.
BEGINTRANSACTION BeginTransaction(String); Cette méthode permet de débuter une transaction de base de données avec le nom de transaction spécifié.
BEGINTRANSACTION BeginTransactionAsync(CancellationToken); Cette méthode permet de débuter de manière désynchronisé une transaction de base de données, laquelle est hérité de DbConnection.
BEGINTRANSACTIONASYNC BeginTransactionAsync(IsolationLevel, CancellationToken); Cette méthode permet de débuter de manière désynchronisé une transaction de base de données, laquelle est hérité de DbConnection.
CHANGEDATABASE ChangeDatabase(String); Cette méthode permet de modifier la base de données actuelle d'une connexion SqlConnection déjà établie.
CHANGEDATABASEASYNC ChangeDatabaseAsync(String, CancellationToken); Cette méthode permet de modifier de manière désynchronisé la base de données actuelle pour une connexion ouverte, laquelle est hérité de DbConnection.
CHANGEPASSWORD ChangePassword(String, SqlCredential, SecureString); Cette méthode permet de modifier le mot de passe SQL Server pour l'utilisateur indiqué dans l'objet SqlCredential.
CHANGEPASSWORD ChangePassword(String, String); Cette méthode permet de remplacer le mot de passe SQL Server de l'utilisateur spécifié dans la chaîne de caractères de connexion par le nouveau mot de passe indiqué.
CLEARALLPOOLS ClearAllPools(); Cette méthode permet de vider le bassin de connexions.
CLEARPOOL ClearPool(SqlConnection); Cette méthode permet de vider le bassin de connexions associé à la connexion spécifiée.
CLOSE Close(); Cette méthode permet de fermer la connexion à la base de données. C'est la méthode recommandée de fermeture d'une connexion déjà ouverte.
CREATECOMMAND CreateCommand(); Cette méthode permet de créer et de retourner un objet SqlCommand associé à SqlConnection.
CREATEDBCOMMAND CreateDbCommand(); Cette méthode permet de créer et de retourner un objet DbCommand associé à la connexion active, laquelle est hérité de DbConnection.
DISPOSE Dispose(); Cette méthode permet de libérer la connexion.
DISPOSE Dispose(Boolean); Cette méthode permet de libérer la connexion selon la disposition spécifié.
DISPOSEASYNC DisposeAsync(); Cette méthode permet de supprimer de manière désynchronisé l'objet de connexion, laquelle est hérité de DbConnection.
ENLISTTRANSACTION EnlistTransaction(Transaction); Cette méthode permet de s'inscrire dans la transaction spécifiée, laquelle est hérité de DbConnection.
EQUALS Equals(Object); Cette méthode permet de vérifier si l'objet spécifié est identique à l'objet actuel, laquelle est hérité de Object.
GETHASHCODE GetHashCode(); Cette méthode permet de demander la hachage par défaut, laquelle est hérité de Object.
GETSCHEMA GetSchema(); Cette méthode permet de demander les informations de schéma pour la source de données de ce SqlConnection.
GETSCHEMA GetSchema(String); Cette méthode permet de demander des informations de schéma pour la source de données de ce SqlConnection en utilisant la chaîne de caractères spécifiée pour le nom de schéma.
GETSCHEMA GetSchema(String, String[]); Cette méthode permet de demander les informations de schéma pour la source de données de ce SqlConnection en utilisant la chaîne spécifiée pour le nom de schéma et du tableau de chaînes de caractères spécifié pour les valeurs de restriction.
GETTYPE GetType(); Cette méthode permet de demander le type de l'instance actuelle, laquelle est hérité de Object.
MEMBERWISECLONE MemberwiseClone(); Cette méthode permet de créer une copie superficielle de l'Object actuellement utilisé, laquelle est hérité de Object.
ONSTATECHANGE OnStateChange(StateChangeEventArgs); Cette méthode permet de déclencher l'événement StateChange, laquelle est hérité de DbConnection.
OPEN Open(); Cette méthode permet d'ouvrir une connexion de base de données avec les paramètres de propriété spécifiés par le ConnectionString.
OPENASYNC OpenAsync(); Cette méthode permet d'ouvrir une connexion de base de données désynchronisé avec les paramètres spécifiés par ConnectionString.
OPENASYNC OpenAsync(CancellationToken); Cette méthode permet d'ouvrir une connexion de base de données désynchronisé avec les paramètres de propriété spécifiés par ConnectionString. Le jeton d'annulation peut être utilisé afin de demander l'abandon de l'opération avant que le délai d'attente de connexion s'écoule.
RESETSTATISTICS ResetStatistics(); Cette méthode permet de réinitialiser toutes les valeurs à zéro si les informations de statistiques sont activés.
RETRIEVESTATISTICS RetrieveStatistics(); Cette méthode permet de demander une collection de statistiques de paires de nom et de valeur au moment où la méthode est appelée.
TOSTRING ToString(); Cette méthode permet de demander une chaîne de caractères représentant l'objet actuel, laquelle est hérité de Object.

Légende

    Cette couleur permet d'indiquer qu'il s'agit d'un constructeur d'objet.

Exemple

L'exemple suivant permet d'effectuer une connexion à la base de données «boso» dans l'infonuagique Azure SQL Database (SQL Server) situé sur Azure, et de lire le contenu de la table bosorole :

  1. using System;
  2. using System.Collections.Generic;
  3. using System.Linq;
  4. using System.Text;
  5. using System.Threading.Tasks;
  6. using System.Data.SqlClient;
  7.  
  8. namespace AzureSqlConnectionSamples
  9. {
  10.     class Program
  11.     {
  12.         static void Main(string[] args)
  13.         {
  14.             using (SqlConnection conn = new SqlConnection("Server=tcp:boso.database.windows.net,1433;Initial Catalog=boso;Persist Security Info=False;User ID=gladir;Password=motdepasse;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;"))
  15.             {
  16.                 conn.Open();
  17.                 SqlCommand stmt = new SqlCommand("SELECT RoleId,Name FROM bosorole;", conn);
  18.                 SqlDataReader RS = stmt.ExecuteReader();
  19.                 while (RS.Read())
  20.                 {
  21.                     Console.WriteLine((string)RS["Name"]);
  22.                 }
  23.                 conn.Close();
  24.             }
  25.         }
  26.     }
  27. }

Voir également

Langage de programmation - C# (C Sharp) - Base de données - Affiche une table SQL Server

Dernière mise à jour : Dimanche, le 28 juin 2020