Share via


Método ServerConnection.ExecuteScalar (String)

Executa uma instrução Transact-SQL e retorna a primeira coluna da primeira linha como um valor de objeto.

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

Sintaxe

'Declaração
Public Function ExecuteScalar ( _
    sqlCommand As String _
) As Object
'Uso
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

Parâmetros

  • sqlCommand
    Tipo: String
    Um valor String que especifica o comando Transact-SQL a ser executado.

Valor de retorno

Tipo: Object
Um valor do objeto do sistema Object que especifica a primeira coluna da primeira linha do conjunto de resultados.

Exemplos

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

Consulte também

Referência

ServerConnection Classe

Sobrecarregado ExecuteScalar

Namespace Microsoft.SqlServer.Management.Common