Esecuzione di un comando

  • Articolo

In ogni provider di dati .NET Framework fornito con .NET Framework è incluso un oggetto comando che eredita da DbCommand. Nel provider di dati .NET Framework per OLE DB è incluso un oggetto OleDbCommand, in quello per SQL Server un oggetto SqlCommand, in quello per ODBC un oggetto OdbcCommand e in quello per Oracle un oggetto OracleCommand. Ognuno di questi oggetti espone metodi per l'esecuzione di comandi in base al tipo di comando e al valore restituito desiderato, come descritto nella tabella seguente.

Comando Valore restituito
ExecuteReader Restituisce un oggetto DataReader.
ExecuteScalar Restituisce un singolo valore scalare.
ExecuteNonQuery Esegue un comando che non restituisce righe.
ExecuteXMLReader Restituisce un valore XmlReader. Disponibile solo per un oggetto SqlCommand.

Ogni oggetto comando fortemente tipizzato supporta anche un'enumerazione CommandType che specifica la modalità di interpretazione di una stringa di comando, come descritto nella tabella seguente.

CommandType Descrizione
Text Comando SQL che definisce le istruzioni da eseguire nell'origine dati.
StoredProcedure Nome della stored procedure. È possibile usare la proprietà Parameters di un comando per accedere a parametri di input e output e a valori restituiti indipendentemente dal metodo Execute chiamato. Quando si usa ExecuteReader, non è possibile accedere ai valori restituiti e ai parametri di output fino a quando DataReader non viene chiuso.
TableDirect Nome di una tabella.

Esempio

Nell'esempio di codice seguente viene illustrato come creare un oggetto SqlCommand per eseguire una stored procedure impostando le relative proprietà. Per specificare il parametro di input per la stored procedure, viene usato un oggetto SqlParameter. Il comando viene eseguito usando il metodo ExecuteReader e l'output di SqlDataReader viene visualizzato nella finestra della console.

static void GetSalesByCategory(string connectionString,
    string categoryName)
{
    using (SqlConnection connection = new(connectionString))
    {
        // Create the command and set its properties.
        SqlCommand command = new()
        {
            Connection = connection,
            CommandText = "SalesByCategory",
            CommandType = CommandType.StoredProcedure
        };

        // Add the input parameter and set its properties.
        SqlParameter parameter = new()
        {
            ParameterName = "@CategoryName",
            SqlDbType = SqlDbType.NVarChar,
            Direction = ParameterDirection.Input,
            Value = categoryName
        };

        // Add the parameter to the Parameters collection.
        command.Parameters.Add(parameter);

        // Open the connection and execute the reader.
        connection.Open();
        using (SqlDataReader reader = command.ExecuteReader())
        {
            if (reader.HasRows)
            {
                while (reader.Read())
                {
                    Console.WriteLine("{0}: {1:C}", reader[0], reader[1]);
                }
            }
            else
            {
                Console.WriteLine("No rows found.");
            }
            reader.Close();
        }
    }
}

Shared Sub GetSalesByCategory(ByVal connectionString As String, _
    ByVal categoryName As String)

    Using connection As New SqlConnection(connectionString)

        ' Create the command and set its properties.
        Dim command As SqlCommand = New SqlCommand()
        command.Connection = connection
        command.CommandText = "SalesByCategory"
        command.CommandType = CommandType.StoredProcedure

        ' Add the input parameter and set its properties.
        Dim parameter As New SqlParameter()
        parameter.ParameterName = "@CategoryName"
        parameter.SqlDbType = SqlDbType.NVarChar
        parameter.Direction = ParameterDirection.Input
        parameter.Value = categoryName

        ' Add the parameter to the Parameters collection.
        command.Parameters.Add(parameter)

        ' Open the connection and execute the reader.
        connection.Open()
        Using reader As SqlDataReader = command.ExecuteReader()

            If reader.HasRows Then
                Do While reader.Read()
                    Console.WriteLine("{0}: {1:C}", _
                      reader(0), reader(1))
                Loop
            Else
                Console.WriteLine("No rows returned.")
            End If
        End Using
    End Using
End Sub

Risoluzione dei problemi dei comandi

Con il provider di dati .NET Framework per SQL Server vengono aggiunti contatori delle prestazioni che consentono l'individuazione dei problemi intermittenti relativi a comandi non eseguiti correttamente. Per altre informazioni, vedere Contatori delle prestazioni.

Vedi anche