建立連接字串

概觀

數據存取工具可協助您建立兩種基本類型的連接字串之一：儲存在通用數據連結 （.udl） 檔案中的 OLE DB 連接字串串，以及儲存在文字連接字串檔案中的 ADO.NET 連接字元串 （*.txt）。

建立 .udl 檔案的連接字串

通用數據連結 （.udl） 檔案基本上是包含 OLE DB 數據源連接字串的文字檔。 您可以使用適當的 DB2OleDbConnectionString 或 FileSysOleDbConnectionString 建構函式建立 .udl 檔案，然後使用 呼叫 Save將字串儲存至次要記憶體。 數據存取連結庫會自動建立適當的 .udl 檔案來儲存字串，並將檔案儲存至磁碟。

1. 藉由呼叫連接字串建構函式來建立空的連接字串。

   呼叫建構函式會建立具有預設設定的連接字串。 這些預設設定只能透過資料存取工具使用者介面來設定。

   如果您針對目前存在的檔案使用檔案路徑，系統會改為在該檔案中載入連接字串資訊。

   您可以使用呼叫 DataAccessSettings.MakeUDLPath來判斷系統用來儲存 .udl 檔案的預設路徑。 DataAccessSettings 也會儲存 DSN 和 HCD 檔案的預設路徑。

2. 呼叫各種連接字串屬性，例如 DataSourceName、 UserName或 Password，將相關的連接資訊新增至連接字串。

   您也可以使用 呼叫 GetString來擷取完整的連接字串做為文字字串，然後使用 儲存修改過的字串 SetString。

3. 透過呼叫相關的Save 方法來儲存字串，例如 DB2OleDbConnectionString.Save。

   系統會將連接字串儲存在 .udl 檔案中。 系統會使用建構函式參數中 name 傳遞的檔案路徑，建立 .udl 檔案。 如果檔案未包含完整路徑，系統會使用預設路徑，如 中所述 DataAccessSettings.UDLpath。

   下列程式代碼範例示範如何使用新的檔名、使用者名稱和密碼建立 .udl 檔案。

   謹慎

   此範例或指引會參考敏感性資訊，例如連接字串或使用者名稱和密碼。 請勿在程式代碼中硬式編碼這些值，並確定您使用最安全的驗證來保護機密數據。 如需詳細資訊，請參閱下列文件：

   • BizTalk Server 中的安全性
   • 傳送和接收訊息的安全性
   • 訪問控制和數據安全性

   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;  
      }  
   }  
   

另請參閱

資料存取程式庫任務