L’ACCES AUX DONNEES EN MODE CONNECTE

Quelques propriétés et méthodes de l’objet SqlConnection

Méthodes publiques
Méthode Description
Open Ouvre la connexion vers une base de données avec les paramètres
spécifiés dans la propriété ConnectionString.
Close Ferme la connexion.
BeginTransaction Lance une nouvelle transaction, en créant un objet de la classe
SqlTransaction qui fournit les méthodes commit et rollback
CreateCommand Crée et retourne un objet SqlCommand associé à SqlConnection
ChangeDatabase Modifie la base de données en cours d'un SqlConnection ouvert.

Propriétés publiques
Propriété Description
ConnectionString pour définir la connexion à une source de données : serveur, base de données,
utilisateur….
State Obtient l'état actuel de la connexion.
Database Obtient le nom de la base de données en cours ou de la base de données à
utiliser une fois la connexion ouverte
CommandTimeout Nombre de secondes d'attente avant de renvoyer une
erreur, suite à une tentative d'exécution d'une commande

WorkstationId Chaîne qui identifie le client de la base de données. S'il n'est pas spécifié, nom
de l'ordinateur client.

Quelques propriétés et méthodes de l’objet Command

Méthodes publiques
Méthode Description
CreateParameter Crée un nouvel objet Paramètre.
ExecuteNonQuery Exécute la commande et renvoie le nombre de lignes affectées dans le cas de
INSERT, UPDATE et DELETE, et renvoie -1 dans le cas de SELECT
ExecuteReader Exécute la commande et crée un objet DataReader
ExecuteScalar Exécute la commande et récupère un résultat unique sans créer de jeu de
données.
Prepare Permet de compiler la requête avant de l’exécuter

Propriétés publiques
Propriété Description
CommandText Définit le texte de la requête SQL, le nom de la table, ou le nom de la procédure
stockée
CommandTimeOut Définit le temps avant la levée d’une exception, si la commande n’aboutit pas
CommandeType Type de la commande. Valeurs possibles :
Text : Requête SQL
StoredProc : Procédure stockée
TableDirect :Table (cette valeur n’existe que pour OleDbCommand)
Connection Renvoie ou définit la connexion sur laquelle la commande est définie
Transaction Renvoie ou définit la transaction à laquelle appartient la commande
Parameters Renvoie la collection des objets Parameters d’une commande

1
 Quelques propriétés et méthodes des paramètres

Méthodes publiques de la collection Parameters

Méthode Description
Add Permet d’ajouter un nouveau paramètre à la collection. Par ex :
commande.Parameters.Add ( New SqlParameter("@num", SqlDbType.Int, 4)

Propriétés publiques de l’objet Parameter

Propriété Description
DBType Définit le type du paramètre.
Prend l’une des valeurs suivantes :
Direction Input : paramètre d’entrée
InputOutput : paramètre d’entrée sortie
Output : paramètre de sortie
ReturnValue : représente un code retour

Quelques propriétés et méthodes de l’objet DataReader

Méthodes publiques
Méthode Description
Close Ferme le DataReader.
GetDateTime, Renvoie la valeur d’une colonne sous la forme d’une donnée typée. On utilise la
GetDouble, méthode IsDbNull avant, pour vérifier que la colonne n’est pas nulle.
GetBoolean…..
GetSchemaTable Permet de récupérer les informations des colonnes (schéma des données) dans
un objet DataTable.
IsDbNull Renvoie vrai si la donnée est nulle.
NextResult Permet de changer de jeu d’enregistrements (dans le cas où l’on a plusieurs jeux
d’enregistrements, issus de plusieurs requêtes qui s’exécutent à la suite)
Read Se positionne sur l’enregistrement suivant. Renvoie True s’il existe une ligne
suivante, False sinon. Ne fait pas la récupération des valeurs. Au début (à la
création du DataReader), on est positionné avant le premier enregistrement. Il
faut donc faire un Read.

Propriétés publiques
Propriété Description
FieldCount Renvoie le nombre de colonnes présentes dans la ligne en cours
HasRow Renvoie vrai si le jeu d’enregistrements contient au moins une ligne
IsClosed Renvoie vrai si l’objet est fermé
Item Renvoie la valeur de la colonne. On peut identifier la colonne par son nom ou par
sa position ordinale. On peut omettre la propriété item. (Rd.Item(“montant”),
Rd.Item(0) et Rd(0) sont équivalentes)

2
 Quelques propriétés et méthodes de l’objet Transaction

Méthodes publiques
Méthode Description
Commit Valide la totalité de la transaction
Rollback Annule la transaction jusqu’au dernier état stable (soit la création de la
transaction, soit le dernier point Save défini).
Save Crée un point intermédiaire d’enregistrement de la transaction.

Propriétés publiques
Propriété Description
Connection Renvoie la connexion à laquelle est associée la transaction
IsolationLevel Spécifie le niveau d’isolation de cette transaction

L’ACCES AUX données en Mode déconnecté

Quelques propriétés et méthodes des objets DataSet et DataTable

Méthodes publiques de l’objet DataSet

Méthode Description
AcceptChanges Valide toutes les modifications en cours (méthode existant aussi pour les objets
DataTable et DataRow). Bascule toutes les lignes de toutes les tables vers l’état
‘Unchanged’
Clear Supprime toutes les lignes de toutes les tables du DataSet. A faire avant de
recharger un DataSet.
Merge Permet de fusionner deux DataSet
Reset Réinitialise le DataSet dans son état d’origine

Propriétés publiques de l’objet DataSet

Propriété Description
Relations Obtient la collection des relations qui relient les tables et permettent de naviguer
entre tables.
Tables Obtient la collection des tables contenues dans le DataSet.

Méthodes publiques de l’objet DataTableCollection

Méthode Description
Add Ajoute une table à la collection des tables du DataSet

Propriétés publiques de l’objet DataTable

Propriété Description
Columns Obtient la collection des colonnes de la table.
Constraints Obtient la collection des contraintes de la table
PrimaryKey Renvoie un tableau d’objets DataColumn qui contient la ou les colonnes composant
la clé primaire de la table.
Rows Obtient la collection des lignes de la table

3
 Quelques propriétés et méthodes de l’objet DataAdapter

Méthodes publiques
Méthode Description
Fill Permet de récupérer des données vers un DataSet. La valeur retournée est le
nombre de lignes rapatriées. Cette méthode utilise l’objet Command du
DataAdapter défini dans la propriété SelectCommand. Si la connexion est
fermée, le DataAdapter l’ouvre le temps du rapatriement des données, puis la
referme. Si plusieurs jeux d’enregistrements sont rapatriés, il est créé autant
de tables que de jeux.
GetFillParameters Permet de récupérer les paramètres de la requête Select définie dans la
propriété SelectCommand.
Update Cette méthode déclenche l’envoi des modifications faites dans le DataSet vers
la source de données. Elle renvoie le nombre de lignes modifiées. Lors de l’appel
de la méthode ‘Update’, le DataAdapter regarde la propriété ‘RowState’ de
chaque ligne et tente de répercuter les modifications des lignes qui ne sont pas
à ‘Unchanged’.
Pour chaque ligne, la commande concernée (InsertCommand, DeleteCommand ou
UpdateCommand) sera exécutée. Ces commandes peuvent être définies par le
programmeur. Si elles ne sont pas définies, et si la commande concerne une table
unique, l’objet CommandBuilder va générer automatiquement ces commandes à
partir de la commande SelectCommand.

Propriétés publiques
Propriété Description
DeleteCommand Obtient ou définit une requête ou une procédure stockée pour supprimer un
enregistrement dans la source de données.
InsertCommand Obtient ou définit une requête ou une procédure stockée pour créer un
enregistrement dans la source de données.
SelectCommand Obtient ou définit une requête ou une procédure stockée permettant de
rapatrier des données dans le DataSet
UpdateCommand Obtient ou définit une requête ou une procédure stockée pour mettre à jour des
enregistrements dans la source de données.