Créer une chaîne de connexion

Vue d’ensemble

L’outil d’accès aux données peut vous aider à créer l’un des deux types de chaînes de connexion de base : une chaîne de connexion OLE DB stockée dans un fichier de liaison de données universelle (.udl) et une ADO.NET chaîne de connexion stockée dans un fichier de chaîne de connexion texte (*.txt).

Créer un chaîne de connexion pour un fichier .udl

Un fichier de liaison de données universelles (.udl) est essentiellement un fichier texte qui contient les chaîne de connexion d’une source de données OLE DB. Vous pouvez créer un fichier .udl à l’aide du constructeur ou FileSysOleDbConnectionString appropriéDB2OleDbConnectionString, puis enregistrer la chaîne dans le stockage secondaire avec un appel à Save. La bibliothèque d’accès aux données crée automatiquement le fichier .udl approprié dans lequel stocker la chaîne et enregistrer le fichier sur le disque.

1. Créez un chaîne de connexion vide en appelant un constructeur chaîne de connexion.

   L’appel du constructeur crée un chaîne de connexion avec les paramètres par défaut. Ces paramètres par défaut peuvent être définis uniquement via l’interface utilisateur de l’outil d’accès aux données.

   Si vous utilisez un chemin d’accès de fichier pour un fichier qui existe actuellement, le système charge les informations chaîne de connexion dans ce fichier à la place.

   Vous pouvez déterminer le chemin par défaut que votre système utilise pour stocker les fichiers .udl avec un appel à DataAccessSettings.MakeUDLPath. DataAccessSettings stocke également les chemins d’accès par défaut pour les fichiers DSN et HCD.

2. Ajoutez les informations de connexion appropriées au chaîne de connexion en appelant les différentes propriétés chaîne de connexion, telles que DataSourceName, UserNameou Password.

   Vous pouvez également récupérer la chaîne de connexion complète sous forme de chaîne de texte avec un appel à GetString, puis enregistrer la chaîne modifiée avec SetString.

3. Enregistrez la chaîne en appelant la méthode appropriée Save , telle que DB2OleDbConnectionString.Save.

   Le système enregistre le chaîne de connexion dans un fichier .udl. Le système crée le fichier .udl à l’aide du chemin d’accès du fichier transmis dans le name paramètre du constructeur. Si le fichier ne contient pas le chemin d’accès complet, le système utilise le chemin par défaut, comme décrit dans DataAccessSettings.UDLpath.

   L’exemple de code suivant montre comment créer un fichier .udl à l’aide d’un nouveau nom de fichier, d’un nom d’utilisateur et d’un mot de passe.

static DB2OleDbConnectionString CreateUDLFile(string FileName, string NameOfUser, string PassWord, ref System.Exception myException)  
{  
   try  
   {  
      DB2OleDbConnectionString myConnection = new DB2OleDbConnectionString(FileName, false);  
      myConnection.UserName = NameOfUser;  
      myConnection.Password = PassWord;  
      myConnection.Save();  
      System.Exception MyEx= new System.Exception(@"Successful Creation", null);  
      myException = MyEx;  
      return myConnection;  
  
   }  
   catch (Exception ex)  
   {  
      myException = ex;  
      return null;  
   }  
}  

Voir aussi

Tâches de la bibliothèque d’accès aux données