• Article

ServerConnection.ExecuteScalar Method (String)

Executes a Transact-SQL statement and returns the first column of the first row as an object value.

Namespace:  Microsoft.SqlServer.Management.Common
Assembly:  Microsoft.SqlServer.ConnectionInfo (in Microsoft.SqlServer.ConnectionInfo.dll)

Syntax

'Declaration
Public Function ExecuteScalar ( _
    sqlCommand As String _
) As Object
'Usage
Dim instance As ServerConnection
Dim sqlCommand As String
Dim returnValue As Object

returnValue = instance.ExecuteScalar(sqlCommand)

public Object ExecuteScalar(
    string sqlCommand
)

public:
Object^ ExecuteScalar(
    String^ sqlCommand
)

member ExecuteScalar : 
        sqlCommand:string -> Object 

public function ExecuteScalar(
    sqlCommand : String
) : Object

Parameters

  • sqlCommand
    Type: System.String
    A String value that specifies the Transact-SQL command to be executed.

Return Value

Type: System.Object
An Object system object value that specifies the first column of the first row of the result set.

Examples

C#

ServerConnection conn = new ServerConnection();
conn.DatabaseName = "AdventureWorks2008R2";
costData = conn.ExecuteScalar("SELECT CostRate FROM Production.Location");
Console.WriteLine(costData.ToString());

PowerShell

$conn = new-object Microsoft.SqlServer.Management.Common.ServerConnection
$conn.DatabaseName = "AdventureWorks2008R2"
$reader = $conn.ExecuteScalar("SELECT CostRate FROM Production.Location")
Write-Host $reader