OracleCommand.ExecuteScalar 方法

定義

命名空間:

System.Data.OracleClient

組件:

System.Data.OracleClient.dll

執行查詢，並傳回查詢以 .NET 資料型別形式所傳回的結果集第一個資料列的第一個資料行。 額外的資料行或資料列都會遭到忽略。

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

public override object ExecuteScalar ();

override this.ExecuteScalar : unit -> obj

Public Overrides Function ExecuteScalar () As Object

傳回

Object

.NET 資料型別之結果集第一個資料列的第一個資料行；或如果結果集是空的或結果是 REF CURSOR，則為 Null 參考。

範例

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

public void CreateOracleCommand(string myScalarQuery, OracleConnection connection)
 {
    OracleCommand command = new OracleCommand(myScalarQuery, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
 }

Public Sub CreateOracleCommand(myScalarQuery As String, connection As OracleConnection)
    Dim command As New OracleCommand(myScalarQuery, connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub

備註

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

典型的 ExecuteScalar 查詢可以格式化為下列 C# 範例：

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

另請參閱

• 使用命令