Hxj.Data 預存程序執行：FromProc、參數輸入輸出、返回值完整指南

FromProc 方法啟動預存程序查詢

無參數預存程序

DbSession.Default.FromProc("Ten Most Expensive Products").ToDataTable();

輸入參數：AddInParameter

DbSession.Default.FromProc("Sales by Year")
    .AddInParameter("Beginning_Date", DbType.DateTime, "1995-01-01")
    .AddInParameter("Ending_Date", DbType.DateTime, "1996-12-01")
    .ToDataTable();

對應預存程序：

CREATE PROCEDURE "Sales by Year"
    @Beginning_Date DateTime, @Ending_Date DateTime AS
SELECT Orders.ShippedDate, Orders.OrderID, "Order Subtotals".Subtotal, DATENAME(yy,ShippedDate) AS Year
FROM Orders INNER JOIN "Order Subtotals" ON Orders.OrderID = "Order Subtotals".OrderID
WHERE Orders.ShippedDate BETWEEN @Beginning_Date AND @Ending_Date

輸出/輸入輸出/返回值參數

執行並取得輸出參數

var cmd = DbSession.Default.FromProc("MyProc")
    .AddInParameter("@InParam", DbType.Int32, 10)
    .AddOutParameter("@OutParam", DbType.Int32)
    .AddReturnValueParameter("@RetVal", DbType.Int32);

// 執行非查詢
cmd.ExecuteNonQuery();

// 讀取輸出
int outVal = (int)cmd.GetParameterValue("@OutParam");
int retVal = (int)cmd.GetParameterValue("@RetVal");

交易支援

DbTrans trans = DbSession.Default.BeginTransaction();
DbSession.Default.FromProc("MyProc").SetDbTransaction(trans).ExecuteNonQuery();
trans.Commit();

最佳實務

• 參數名稱**必須包含 @ 前綴**（如 @Beginning_Date），與資料庫定義一致。
• DbType 需與資料庫參數型別對應，避免隱性轉換錯誤。
• 僅查詢結果集用 ToDataTable/ToList；需輸出參數時用 ExecuteNonQuery + GetParameterValue。
• 複雜業務邏輯優先放預存程序，ORM 僅負責呼叫與參數綁定。

FromProc 讓 Hxj.Data 完整支援預存程序，參數處理型別安全、交易整合無縫，是 Legacy 資料庫遷移與高效能批次作業的關鍵橋樑。

1. 上一篇文章： Hxj.Data DbSession 輔助統計方法：Sum/Avg/Count/Max/Min 一鍵完成聚合查詢
2. 下一篇文章： Hxj.Data 直接 SQL 執行：FromSql、參數化、DbParameter 陣列與鏈式 AddInParameter

關於ASP.NET

ASP.NET SignalR 實現即時訊息推送：原理、環境建置與 Demo 實作

ASP.NET SignalR 實現即時訊息推送：原理、環境

解決 Visual Studio 設計時「呈現控件時出錯」的根因與對策

前言 開發自訂控制項時，設計介面常出現「呈現控件時出錯：未將

ASP.NET MVC 專案目錄結構與核心組件：App_Data、Content、Controllers、Models、Views 詳細規範

前言 ASP.NET MVC 專案採用慣例優於配置，標準目錄

ASP.NET 2.0 資料教程 75（上）：Managed Code 建立 Stored Procedure 與 UDF 完整流程、Northwind 資料庫移出 App_Data 註冊實例

前言 SQL Server 2005 引入 CLR 整合，允