執行命令

Command 物件公開數個 Execute 方法供您執行想要進行的動作。若想將結果以資料流傳回,請使用 ExecuteReader 來傳回 DataReader 物件、使用 ExecuteScalar 傳回單一數值,而使用 ExecuteNonQuery 來執行不傳回資料列的命令。

使用 Command 物件配合預存程序時,您可以將 Command 物件的 CommandType 屬性設定為 StoredProcedure。透過 StoredProcedureCommandType,您可以使用 CommandParameters 屬性來存取輸入、輸出參數並傳回值。不論是否呼叫 Execute 方法,都可以存取 Parameters 屬性。但是呼叫 ExecuteReader 時,必須等到 DataReader 關閉後才能存取傳回值和輸出參數。

下列程式碼範例示範如何建立 SqlCommand 物件,從 SQL Server 的 Northwind 範例資料庫中傳回分類清單。

範例

' nwindConn is assumed to be a valid SqlConnection object.
Dim command As SqlCommand = New SqlCommand( _
  "SELECT CategoryID, CategoryName FROM dbo.Categories", nwindConn)
// nwindConn is assumed to be a valid SqlConnection object.
SqlCommand command = new SqlCommand(
  "SELECT CategoryID, CategoryName FROM dbo.Categories", nwindConn);

命令的效能計數器

SQL Server 的 .NET Framework 資料提供者加入一個效能計數器,可讓您偵測與失敗命令執行相關的週期性問題。您可以存取效能監視器之 .NET CLR Data 效能物件下的 SqlClient: Total # failed commands 計數器,以判斷因任何原因而執行失敗的命令總數。

Note注意事項

搭配使用「SQL Server 的 .NET Framework 資料提供者」效能計數器與 ASP.NET 應用程式時,建議只使用 _Global 執行個體。因此,效能計數器所傳回的值是所有 ASP.NET 應用程式計數器值的總和。

請參閱

概念

使用預存程序配合命令
從資料庫取得單一數值

其他資源

使用命令