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 = "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

See Also

Reference

ServerConnection Class

ExecuteScalar Overload

Microsoft.SqlServer.Management.Common Namespace