OleDbCommand.ExecuteScalar 方法

定義

命名空間:

System.Data.OleDb

組件:

System.Data.OleDb.dll

套件:

System.Data.OleDb v9.0.0-rc.2.24473.5

來源:

OleDbCommand.cs

執行查詢，並傳回查詢所傳回之結果集中第一個資料列的第一個資料行。 忽略其他資料行或資料列。

public:
 override System::Object ^ ExecuteScalar();

public override object? ExecuteScalar ();

override this.ExecuteScalar : unit -> obj

Public Overrides Function ExecuteScalar () As Object

傳回

Object

結果集中第一個資料列的第一個資料行，如果結果集為空白，則為 null 參考。

實作

ExecuteScalar()

例外狀況

InvalidOperationException

如果某項交易內容與原本連接登記的內容不同，便無法在那個交易內容中執行命令。

範例

下列範例會建立 ， OleDbCommand 然後使用 執行它 ExecuteScalar。 此範例會傳遞字串，該字串是傳回匯總結果的 SQL 語句，以及用來連接到數據源的字串。

public void CreateMyOleDbCommand(string queryString,
    OleDbConnection connection)
{
    OleDbCommand command = new OleDbCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}

Public Sub CreateMyOleDbCommand(queryString As String, _
    connection As OleDbConnection)
    Dim command As New OleDbCommand(queryString, connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub

備註

ExecuteScalar使用 方法，從數據源擷取單一值，例如匯總值。 這需要比使用 ExecuteReader 方法少的程式代碼，然後執行使用 傳回的數據產生單一 OleDbDataReader值所需的作業。

一般 ExecuteScalar 查詢的格式可以如下列 C# 範例所示：

CommandText = "SELECT COUNT(*) FROM region";  
Int32 count = (Int32) ExecuteScalar();  

另請參閱

• 使用命令