IDbCommand.ExecuteScalar Metodo

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.Common.dll

Esegue la query e restituisce la prima colonna della prima riga nel set di risultati restituito dalla query. Le colonne o le righe aggiuntive vengono ignorate.

public:
 System::Object ^ ExecuteScalar();

public object? ExecuteScalar ();

abstract member ExecuteScalar : unit -> obj

Public Function ExecuteScalar () As Object

Restituisce

Object

Prima riga della prima colonna nel set di risultati.

Esempio

Nell'esempio seguente viene creata un'istanza della classe derivata, SqlCommand, e quindi la esegue usando ExecuteScalar. Nell'esempio viene passata una stringa che rappresenta un'istruzione Transact-SQL che restituisce un risultato aggregato e una stringa da usare per connettersi all'origine dati.

public void CreateSqlCommand(
    string queryString, SqlConnection connection)
{
    SqlCommand command = new
        SqlCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}

Public Sub CreateSqlCommand( _
    queryString As String, connection As SqlConnection)

    Dim command As New SqlCommand(queryString, connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub

Commenti

Utilizzare il ExecuteScalar metodo per recuperare un singolo valore , ad esempio un valore di aggregazione, da un database. Questo richiede meno codice rispetto all'uso del metodo e quindi l'esecuzione ExecuteReader delle operazioni necessarie per generare il singolo valore usando i dati restituiti da un IDataReaderoggetto .

Una query tipica ExecuteScalar può essere formattata come nell'esempio C# seguente:

CommandText = "select count(*) as NumberOfRegions from region";  
Int32 count = (int) ExecuteScalar();  

Se non viene trovata la prima colonna della prima riga del set di risultati, viene restituito un riferimento Null (Nothing in Visual Basic). Se il valore nel database è null, la query restituisce DBNull.Value.