Créer une chaîne de connexion

Aperçu

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 lien de données universel (.udl) et une chaîne de connexion ADO.NET stockée dans un fichier de chaîne de connexion texte (*.txt).

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

Un fichier de lien de données universel (.udl) est essentiellement un fichier texte qui contient la chaîne de connexion pour une source de données OLE DB. Vous pouvez créer un fichier .udl en utilisant le constructeur DB2OleDbConnectionString ou FileSysOleDbConnectionString approprié, 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, puis enregistre le fichier sur le disque.

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

   L’appel du constructeur crée une chaîne de connexion avec les paramètres par défaut. Ces paramètres par défaut ne peuvent être définis que 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 de chaîne de connexion dans ce fichier à la place.

   Vous pouvez déterminer le chemin d’accès 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 pertinentes à la chaîne de connexion en appelant les différentes propriétés de chaîne de connexion, telles que DataSourceName, UserNameou Password.

   Vous pouvez également récupérer la chaîne de connexion complète en tant que 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, telle que DB2OleDbConnectionString.Save, Save.

   Le système enregistre la 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 paramètre name 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.

   Avertissement

   Cet exemple ou conseils référence des informations sensibles, telles qu’une chaîne de connexion ou un nom d’utilisateur et un mot de passe. Ne codez jamais en dur ces valeurs dans votre code et veillez à protéger les données confidentielles à l’aide de l’authentification la plus sécurisée disponible. Pour plus d’informations, consultez la documentation suivante :

   • Sécurité dans BizTalk Server
   • Sécurité pour l’envoi et la réception de messages
   • Contrôle d’accès et sécurité des données

   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 bibliothèque d’accès aux données