IDbCommand.ExecuteScalar Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 ();public object ExecuteScalar ();abstract member ExecuteScalar : unit -> objPublic Function ExecuteScalar () As ObjectRestituisce
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.
