了解自訂檔案

  • 發行項

自訂檔案中的每個區段標頭都包含方括弧 ([])，包含類型和參數。 四個區段類型是由常值字串 connect、sql、userlist 或 logs 來表示。 參數是常值字串、預設值、使用者指定的識別碼，或無任何項目。

重要

從 Windows 8 和 Windows Server 2012 開始，Windows 作業系統中不再包含 RDS 伺服器元件 (請參閱 Windows 8 和 Windows Server 2012 相容性逐步指南 (英文) 以取得詳細資料)。 未來的 Windows 版本將移除 RDS 用戶端元件。 請避免在新的開發工作中使用這項功能，並規劃修改目前使用這項功能的應用程式。 使用 RDS 的應用程式應該移轉至 WCF 資料服務。

因此，每個區段都會以下列其中一個區段標頭來標示：

  
[ connect default ] [ connect    
identifier   
] [ sql  default ] [ sql    
identifier   
] [ userlist    
identifier   
] [ logs ]

區段標頭具有下列部分。

部分 描述
connect 修改連接字串的常值字串。
sql 修改命令字串的常值字串。
userlist 修改特定使用者存取權限的常值字串。
記錄 指定記錄檔記錄作業錯誤的常值字串。
預設值 如果未指定或找不到任何識別碼，則會使用常值字串。
identifier 符合 connect 或 command 字串中字串的字串。

- 如果區段標頭包含 connect，而且在連接字串中找到識別碼字串，請使用本節。
- 如果區段標頭包含 sql，且在命令字串中找到識別碼字串，請使用本節。
- 如果區段標頭包含 userlist，且識別碼字串符合 connect 區段識別碼，請使用本節。

DataFactory 會呼叫處理常式，並傳遞用戶端參數。 處理常式會在適當區段標頭中符合識別碼的用戶端參數中搜尋整個字串。 如果找到相符項目，該區段的內容會套用至用戶端參數。

在下列情況下，會使用特定區段：

  • 如果用戶端連接字串關鍵字「Data Source=value」的值部分符合 connect 區段識別碼，則會使用 connect 區段。

  • 如果用戶端命令字串包含符合 sql 區段識別碼的字串，則會使用 sql 區段。

  • 如果沒有相符的識別碼，則會使用具有預設參數的 connect 或 sql 區段。

  • 如果 userlist 區段識別碼符合 connect 區段識別碼，則會使用 userlist 區段。 如果有相符項目，userlist 區段的內容會套用至 connect 區段所控管的連線。

  • 如果連接字串或命令字串中的字串不符合任何 connect 或 sql 區段標頭中的識別碼，且沒有包含預設參數的 connect 或 sql 區段標頭，則會使用用戶端字串而不進行修改。

  • 每當 DataFactory 在作業中時，就會使用 logs 區段。

另請參閱

自訂檔案 Connect 區段
自訂檔案 Logs 區段
自訂檔案 SQL 區段
自訂檔案 UserList 區段
DataFactory 自訂
必要用戶端設定
撰寫您自己的自訂處理常式