IDbCommand Interfaccia

Definizione

Spazio dei nomi:
System.Data
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Rappresenta un'istruzione SQL eseguita durante la connessione a un'origine dati e implementata da .NET provider di dati che accedono a database relazionali.

public interface class IDbCommand : IDisposable
public interface IDbCommand : IDisposable
type IDbCommand = interface
    interface IDisposable
Public Interface IDbCommand
Implements IDisposable
Derivato
Implementazioni
IDisposable

Esempio

Nell'esempio seguente vengono create istanze delle classi derivate, SqlConnection, SqlCommande SqlDataReader. L'esempio legge i dati, scrivendoli nella console. Infine, l'esempio chiude , SqlDataReaderquindi .SqlConnection

private static void ReadOrderData(string connectionString)
{
    string queryString =
        "SELECT OrderID, CustomerID FROM dbo.Orders;";
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(
            queryString, connection);
        connection.Open();
        using(SqlDataReader reader = command.ExecuteReader())
        {
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}, {1}",
                    reader[0], reader[1]));
            }
        }
    }
}

Public Sub ReadOrderData(ByVal connectionString As String)
    Dim queryString As String = _
        "SELECT OrderID, CustomerID FROM dbo.Orders;"
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        connection.Open()
        Dim reader As SqlDataReader = command.ExecuteReader()
        Try
            While reader.Read()
                Console.WriteLine(String.Format("{0}, {1}", _
                    reader(0), reader(1)))
            End While
        Finally
            ' Always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

Commenti

L'interfaccia IDbCommand consente a una classe che eredita di implementare una classe Command, che rappresenta un'istruzione SQL eseguita in un'origine dati. Per altre informazioni sulle classi Command, vedere Esecuzione di un comando.

Un'applicazione non crea direttamente un'istanza dell'interfaccia IDbCommand , ma crea un'istanza di una classe che implementa l'interfaccia IDbCommand .

Le classi che implementano IDbCommand devono implementare tutti i relativi membri e in genere definiscono membri aggiuntivi per aggiungere funzionalità specifiche del provider. Ad esempio, l'interfaccia IDbCommand definisce il ExecuteNonQuery metodo . A sua volta, la SqlCommand classe eredita questo metodo e definisce anche il ExecuteXmlReader metodo .

Note per gli implementatori

Per promuovere la coerenza tra i provider di dati .NET Framework, denominare la classe che eredita nel formato PrvClassname dove Prv è il prefisso uniforme assegnato a tutte le classi in uno spazio dei nomi specifico del provider di dati .NET Framework. Ad esempio, Sql è il prefisso della SqlCommand classe nello spazio dei System.Data.SqlClient nomi .

Quando si eredita dall'interfaccia IDbCommand , è necessario implementare i costruttori seguenti:

Elemento Descrizione
PrvCommand() Inizializza una nuova istanza della classe PrvCommand.
PrvCommand(string cmdText) Inizializza una nuova istanza della classe PrvCommand con il testo della query.
PrvCommand(string cmdText, PrvConnection connection) Inizializza una nuova istanza della classe PrvCommand con il testo della query e prvConnection.
PrvCommand(string cmdText, PrvConnection connection, PrvTransaction transaction) Inizializza una nuova istanza della classe PrvCommand con il testo della query, un prvConnection e prvTransaction.

Proprietà

Nome Descrizione
CommandText

Ottiene o imposta il comando di testo da eseguire sull'origine dati.
CommandTimeout

Ottiene o imposta il tempo di attesa , espresso in secondi, prima di terminare il tentativo di eseguire un comando e generare un errore.
CommandType

Indica o specifica la modalità di interpretazione della CommandText proprietà.
Connection

Ottiene o imposta l'oggetto IDbConnection utilizzato da questa istanza di IDbCommand.
Parameters

Ottiene l'oggetto IDataParameterCollection.
Transaction

Ottiene o imposta la transazione all'interno della quale viene eseguito l'oggetto Command di un provider di dati .NET.
UpdatedRowSource

Ottiene o imposta la DataRow modalità di applicazione dei risultati del comando a quando viene utilizzato dal Update(DataSet) metodo di un oggetto DbDataAdapter.

Metodi

Nome Descrizione
Cancel()

Tenta di annullare l'esecuzione di un oggetto IDbCommand.
CreateParameter()

Crea una nuova istanza di un IDbDataParameter oggetto .
Dispose()

Esegue attività definite dall'applicazione associate alla liberazione, al rilascio o alla reimpostazione di risorse non gestite.

(Ereditato da IDisposable)
ExecuteNonQuery()

Esegue un'istruzione SQL sull'oggetto Connection di un provider di dati .NET e restituisce il numero di righe interessate.
ExecuteReader()

Esegue l'oggetto sull'oggetto CommandTextConnection e compila un oggetto IDataReader.
ExecuteReader(CommandBehavior)

Esegue l'oggetto CommandTextConnectionsu e compila un IDataReader oggetto usando uno dei CommandBehavior valori .
ExecuteScalar()

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.
Prepare()

Crea una versione preparata (o compilata) del comando nell'origine dati.

Si applica a

Vedi anche