SqlCeCommand.ExecuteScalar メソッド

メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。

クエリを実行し、そのクエリが返す結果セットの最初の行にある最初の列を返します。残りの列または行は無視されます。

Public Overridable Function ExecuteScalar() As Object Implements _   IDbCommand.ExecuteScalar
[C#]
public virtual object ExecuteScalar();
[C++]
public: virtual Object* ExecuteScalar();
[JScript]
public function ExecuteScalar() : Object;

戻り値

結果セット内の最初の行の最初の列。

実装

IDbCommand.ExecuteScalar

例外

解説

データ ソースから単一の値 (集計値など) を取得するには、 ExecuteScalar メソッドを使用します。 ExecuteReader メソッドを使用し、 SqlCeDataReader によって返されたデータから単一値を生成するよりも、このメソッドを使用した方がコードが簡潔になります。

使用例

[Visual Basic, C#] SqlCeCommand を作成し、 ExecuteScalar を使用して実行する例を次に示します。この例では、集計結果を返す SQL ステートメントの文字列と、データ ソースへの接続用の文字列が渡されます。

 
Public Sub CreateMySqlCeCommand(ByVal myScalarQuery As String, ByVal myConnection As SqlCeConnection)
    Dim myCommand As New SqlCeCommand(myScalarQuery, myConnection)
    myCommand.Connection.Open()
    myCommand.ExecuteScalar()
    myConnection.Close()
End Sub

[C#] 
public void CreateMySqlCeCommand(string myScalarQuery, SqlCeConnection myConnection) {
    SqlCeCommand myCommand = new SqlCeCommand(myScalarQuery, myConnection);
    myCommand.Connection.Open();
    myCommand.ExecuteScalar();
    myConnection.Close();
}

[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: .NET Compact Framework - Windows CE .NET

.NET Framework セキュリティ:

• 直前の呼び出し元の完全信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細の参照先 : 部分信頼コードからのライブラリの使用

参照

SqlCeCommand クラス | SqlCeCommand メンバ | System.Data.SqlServerCe 名前空間