Méthode ServerConnection.ExecuteScalar (StringCollection)

Article
04/22/2014

Exécute un lot d'instructions Transact-SQL et retourne la première colonne de la première ligne comme valeur d'objet.

Espace de noms : Microsoft.SqlServer.Management.Common
Assembly : Microsoft.SqlServer.ConnectionInfo (en Microsoft.SqlServer.ConnectionInfo.dll)

Syntaxe

'Déclaration
Public Function ExecuteScalar ( _
    sqlCommands As StringCollection _
) As Object()
'Utilisation
Dim instance As ServerConnection 
Dim sqlCommands As StringCollection 
Dim returnValue As Object()

returnValue = instance.ExecuteScalar(sqlCommands)

public Object[] ExecuteScalar(
    StringCollection sqlCommands
)

public:
array<Object^>^ ExecuteScalar(
    StringCollection^ sqlCommands
)

member ExecuteScalar : 
        sqlCommands:StringCollection -> Object[]

public function ExecuteScalar(
    sqlCommands : StringCollection
) : Object[]

Paramètres

sqlCommands
Type : StringCollection
Valeur de l'objet système StringCollection qui spécifie les lots d'instructions Transact-SQL à exécuter.

Valeur de retour

Type : array<Object[]
Valeur de tableau d'objets qui spécifie la première colonne de la première ligne pour chaque jeu de résultats.

Exemples

ServerConnection conn = new ServerConnection();
conn.DatabaseName = "AdventureWorks2012";
StringCollection sqlQuery = new StringCollection();
sqlQuery.Add("SELECT Name FROM Production.Location");
sqlQuery.Add("SELECT CostRate FROM Production.Location");
Object[] costData = conn.ExecuteScalar(sqlQuery);
for (int i = 0; i < costData.Length; i++)
{
   Console.WriteLine(costData[i].ToString());
}

PowerShell

$conn = new-object Microsoft.SqlServer.Management.Common.ServerConnection
$conn.DatabaseName = "AdventureWorks2012"
$sqlQuery = new-object System.Collections.Specialized.StringCollection
$sqlQuery.Add("SELECT Name FROM Production.Location")
$sqlQuery.Add("SELECT CostRate FROM Production.Location")
$costData = $conn.ExecuteScalar($sqlQuery)
$i = 0
while ($i -le $costData.Length)
{
   Write-Host $costData[$i]
   $i++
}