自定義檔案 SQL 區段

sql 區段可以包含取代用戶端命令字串的新 SQL 字串。 如果 區段中沒有 SQL 字串，則會忽略 區段。

重要

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

新的 SQL 字串可能會 參數化。 也就是說，sql 區段 SQL 字串中的參數（由 '？' 字元指定）可以由用戶端命令字串中 標識符中的對應自變數取代（以括弧中的逗號分隔清單所指定）。 標識碼和自變數清單的行為就像函數調用。

例如，假設用戶端命令字串是 "CustomerByID(4)"、SQL 區段標頭是 [SQL CustomerByID]，而新的 SQL 區段字串則 "SELECT * FROM Customers WHERE CustomerID = ?". 處理程式會產生 "SELECT * FROM Customers WHERE CustomerID = 4" 並使用該字串來查詢數據源。

如果新的 SQL 語句是 Null 字串 （“），則會忽略 區段。

如果新的 SQL 語句字串無效，則語句的執行將會失敗。 實際上會忽略客戶端參數。 您可以藉由指定下列命令，刻意執行此動作來「關閉」所有用戶端 SQL 命令：

[SQL default]   
SQL = " "  

語法

取代的 SQL 字串條目的格式如下：

SQL=
sqlString

部分	描述
SQL	字面字串，表示這是 SQL 區段項目。
sqlString	取代用戶端字串的 SQL 字串。

另請參閱

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