USE

Ouvre la table spécifiée, les fichiers mémo associés (.DBT) et les fichiers index d'exploitation (.MDX), s'ils sont présents.

Syntaxe

USE [<fichier 1> | ? | <masque de fichier 1>[ [TYPE] PARADOX | DBASE] [IN <alias>] [INDEX <liste d'index> |     <? liste> | <liste de masques d'index>][ORDER [TAG] <fichier .ndx> |      <repère d'index> [OF <fichier .mdx>] ] [AGAIN][ALIAS <alias>] [AUTOMEM][EXCLUSIVE | SHARED][NOSAVE][NOUPDATE] ]

<fichier 1> | ? | <masque de fichier 1>

Le fichier table que vous voulez ouvrir. USE ? et USE <masque de fichier 1> affichent une boîte de dialogue depuis laquelle vous pouvez sélectionner un fichier table. Si vous spécifiez un fichier sans inclure le chemin d'accès, Visual dBASE le recherche dans le répertoire en cours, puis dans le chemin d'accès défini par SET PATH. Si vous spécifiez un fichier sans inclure d'extension ou sans spécifier son type, Visual dBASE utilise le type de fichier spécifié avec la commande SET DBTYPE.

Vous pouvez aussi ouvrir une table dans une base de données (définie en utilisant l'utilitaire de configuration BDE) en spécifiant la base de données comme préfixe (entourées de deux-points) au nom de la table, ainsi, :base de données:table. Si la base de données n'est pas déjà ouverte, Visual dBASE affiche une boîte de dialogue dans laquelle les paramètres tels que le nom de connexion et le mot de passe doivent être spécifiés, car ils sont nécessaires à l'établissement d'une connexion vers la base de données.

[[TYPE] PARADOX | DBASE]

Spécifie le type de table à ouvrir. Le mot réservé TYPE n'est inclus que pour la lisibilité ; il n'a aucun effet sur l'opération de la commande.
PARADOX ouvre une table Paradox avec l'extension .DB.
dBASE ouvre une table dBASE (par défaut). Si vous n'incluez pas d'extension pour <fichier>, Visual dBASE suppose que l'extension est .DBF.

IN <alias>

Spécifie une zone de travail. Vous pouvez saisir un numéro de zone de travail (1 à 225), une lettre de zone de travail (A à J) ou un nom d'alias.

INDEX <liste d'index> | <? liste> | <liste de masques d'index>

Ne peut être utilisée que sur les index dBASE. Les index de tables SQL ou Paradox sont spécifiés par la clause ORDER. Jusqu'à 100 fichiers index individuels peuvent être ouverts pour la table spécifiée. <liste d'index> peut comprendre des noms de fichiers index simples (.NDX) et multiples (.MDX). Si le premier fichier de la <liste d'index> est un fichier index simple et que l'option ORDER n'est pas utilisée, ce fichier index devient l'index maître. INDEX <? liste> et INDEX <liste de masques d'index> affichent une boîte de dialogue dans laquelle un fichier index existant peut être choisi.

ORDER [TAG] <repère d'index>

Transforme le <repère d'index> en index maître. Lors de l'ouverture d'une table Paradox, vous pouvez spécifier qu'un index secondaire soit l'index maître ; sinon, l'index primaire est utilisé. Lors de l'ouverture d'une table SQL, vous pouvez aussi spécifier un index à utiliser en tant qu'index maître.
Si vous n'incluez pas la clause ORDER et que le premier nom de fichier après INDEX est un fichier index simple .NDX, il devient alors l'index maître. Si vous n'incluez pas ORDER et que le premier nom de fichier après INDEX est un fichier index multiple .MDX, la table n'utilise pas d'index maître.

OF <fichier .mdx>

Le fichier index multiple comprenant le <repère d'index>. Sans OF <fichier>, dBASE recherche le <repère d'index> dans un fichier index multiple de même nom que la table.

ORDER [TAG] <fichier .ndx>

Transforme le fichier index simple (<fichier .ndx>) en index maître.

AGAIN

Ouvre une table et ses fichiers index associés dans la zone de travail en cours ou la zone de travail spécifiée, tout en laissant la table ouverte dans une ou plusieurs zones de travail.

ALIAS <alias>

Spécifie une alternative au nom d'alias pour la table ouverte dans la zone de travail en cours. Le nom d'alias par défaut est le nom de la table, à moins que l'option AGAIN ne soit utilisée. Les zones de travail peuvent aussi être référencées par les lettres A à H ou par les nombres 1 à 225.

AUTOMEM

Initialise une variable mémoire pour chaque champ de la table spécifiée (sans inclure les types mémo, binaire ou OLE). Les variables mémoire ont les mêmes noms et types que les champs.

EXCLUSIVE | SHARED

EXCLUSIVE ouvre la table afin qu'aucun autre utilisateur ne puisse l'ouvrir avant sa fermeture par vos soins ; SHARED permet l'accès aux autres utilisateurs lorsque la table est ouverte. Le paramétrage par défaut dépend de l'accès aux tables en environnement partagé ou du paramètre LOCALSHARE en environnement mono-utilisateur.

NOSAVE

Utilisée pour ouvrir un fichier .DBF comme table temporaire. Lorsqu'un fichier ouvert avec NOSAVE est fermé, il est effacé avec son fichier mémo associé. Si vous avez, par inadvertance, ouvert une table avec l'option NOSAVE, utilisez COPY TO pour sauvegarder les données.

NOUPDATE

Evite aux utilisateurs d'altérer, de supprimer ou de rappeler les enregistrements de la table.

La commande USE ouvre une table existante, un fichier index d'exploitation (.MDX) et le fichier .DBT associé si la table contient des champs Binaire, Mémo ou OLE. De manière facultative, USE ouvre aussi tous les fichiers index .NDX associés ou .MDX (non d'exploitation) spécifiés. Vous devez ouvrir une table avant d'accéder aux données qui y sont stockées.
USE sans argument, ferme la table ouverte, les index et le fichier de format de la zone de travail en cours. USE IN <alias>, sans argument de nom de fichier, ferme la table et les fichiers associés dans la zone de travail spécifiée. CLOSE TABLES ferme les tables dans toutes les zones de travail.

Vous pouvez ouvrir une table dans n'importe quelle zone de travail disponible. Lors de l'ouverture d'une table, vous pouvez donner un nom à la zone de travail en incluant l'option ALIAS dans la ligne de commande USE. Les noms d'ALIAS suivent les mêmes règles que les noms de fichiers. Les alias sont utilisés pour faire référence à une table depuis une autre zone de travail.
USE...INDEX spécifie les fichiers index ouverts et gérés pour une table particulière. L'option ORDER spécifie l'index maître depuis la liste des index ouverts avec l'option INDEX et l'index d'exploitation .MDX. USE...INDEX est identique à USE suivi de SET INDEX. Voir les commandes SET INDEX et SET ORDER pour des explications sur l'ordre des index ouverts et sur les index maître.

Vous pouvez inclure les fichiers index .NDX et .MDX dans l'option INDEX. Si une table a un fichier .NDX et un fichier .MDX de même nom, Visual dBASE ouvre les index listés dans le fichier index .MDX. Dans ce cas, pour ouvrir l'index simple, vous devrez spécifier son nom entier en incluant l'extension.
Utilisez l'option NOSAVE de USE pour ouvrir une table en tant que fichier temporaire. Visual dBASE efface automatiquement la table, avec les fichiers index et mémo associés, lorsque vous fermez la table.

L'option AUTOMEM, qui crée des variables mémoire pour tous les champs de la table (à l'exclusion des champs Binaire, Mémo et OLE), initialise les variables mémoire selon le type de données du champ :

USE...AUTOMEM vous permet de créer des variables mémoire correspondant aux champs d'une table pour la mise à jour des données dans un programme d'application. Voir APPEND AUTOMEM et STORE AUTOMEM pour plus d'informations sur l'utilisation des variables automem.

 En XBASE DML, pour ouvrir une table, vous pouvez utiliser la commande "use".

En OODML, les choses ont changé de façon plutôt spectaculaire. Pour "use" une table, vous devez en fait créer un objet de requête, puis définir les informations appropriées dans la propriété SQL de la requête. Cela laisse penser que vous avez besoin de savoir beaucoup de choses sur SQL, ce n'est pas le cas. Voici la méthode la plus simple d'ouvrir une table en utilisant l'OODML:

La propriété SQL utilise la commande SQL SELECT, pour sélectionner, dans ce cas, tous les champs (le caractère joker "*" est l'endroit où l'on peut limiter les champs), et vous devez préciser le nom de la table.

Si vous utilisez les surfaces de conception, cela devient plus facile. Lorsque vous créez un datamodule, un formulaire ou un rapport, tout ce que vous avez à faire est de glisser la table depuis le navigateur vers la surface de conception. dBASE mettra en place la requête pour vous, en supposant que vous souhaitiez utiliser tous les champs de la table.

Si vous souhaitez définir l'ordre d'affichage de la table (l'index), vous pouvez utiliser la clause SQL "ORDER BY", mais sachez que cela créera généralement une requête en lecture seule, ce qui à l'exception des rapports n'est pas souhaitable ( C'est une question liée au BDE, pas à dBase). Au lieu de cela, il suffit d'utiliser la propriété IndexName du rowset (l'ensemble de lignes) et d'ouvrir un index.

Notez que la dernière déclaration doit venir après la requête soit activée. Si vous ne la mettez pas là, il n'y a pas de jeu de lignes actives, et si aucune erreur ne survient, aucun IndexName est fixé.

Il y a beaucoup de variations qui peuvent être faites avec la propriété SQL, mais elles sont abordées dans d'autres parties ou documents.

retour

Sources :

Aide Visual dbase V5.5

http://www.dbase.com/Knowledgebase/INT/xb2vdb7oodml/x2oodml.htm

Dernière modification : vendredi 06 août 2010

Si vous voyez des erreurs, n'hésitez pas à le signaler.