Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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: String
 A String value that specifies the Transact-SQL command to be executed.
Return Value
Type: 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 = "AdventureWorks2012";
costData = conn.ExecuteScalar("SELECT CostRate FROM Production.Location");
Console.WriteLine(costData.ToString());
PowerShell
$conn = new-object Microsoft.SqlServer.Management.Common.ServerConnection
$conn.DatabaseName = "AdventureWorks2012"
$reader = $conn.ExecuteScalar("SELECT CostRate FROM Production.Location")
Write-Host $reader