共用方式為

瞭解自定義檔案

  • 發行項

自定義檔案中的每個區段標頭都包含方括弧（[]），其中包含類型和參數。 四個區段類型是由常值字串表示，連接、sql、userlist或 記錄。 參數是常值字串、預設值、使用者指定的標識碼或無任何值。

重要

從 Windows 8 和 Windows Server 2012 開始，RDS 伺服器元件已不再包含在 Windows 作業系統中（如需詳細資訊，請參閱 Windows 8 和 Windows Server 2012 兼容性 Cookbook）。 RDS 用戶端元件將在未來的 Windows 版本中移除。 請避免在新的開發工作中使用此功能，並計劃修改目前使用此功能的應用程式。 使用 RDS 的應用程式應該移至 WCF Data Service。

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

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

區段標頭具有下列部分。

部分 描述
連線 修改連接字串的文字串。
sql 用來修改命令字串的字面量字串。
userlist 修改特定使用者訪問許可權的常值字串。
記錄 指定記錄作業錯誤的記錄檔字面字串。
默認 未指定或找到識別子時使用的常值字串。
識別碼 與 連接 或 命令 字串相符的字串。

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

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

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

  • 如果用戶端連接字串關鍵詞的值部分「數據源=值」，相符 連接 段標識符，將使用 連接 段。

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

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

  • 如果 userlist 區段標識符符合 connect 區段標識符，則會使用 userlist 區段。 如果有符合條件的情況，userlist 區段的內容會應用到 connect 區段所控管的連接。

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

  • 每當 DataFactory 運作時，就會使用 記錄 區段。

另請參閱

自訂文件連接區段
自定義檔案記錄區段
自定義檔案 SQL 區段
自定義檔案 UserList 區段
DataFactory 自定義
必要的客戶端設定
撰寫您自己的自定義處理程式