DbCommand Classe

Définition

Espace de noms:

System.Data.Common

Assembly:

System.Data.dll

Représente une instruction SQL ou une procédure stockée à exécuter sur une source de données. Fournit une classe de base pour les classes spécifiques à la base de données qui représentent des commandes. ExecuteNonQueryAsync.

public ref class DbCommand abstract : System::ComponentModel::Component, IDisposable, System::Data::IDbCommand

public abstract class DbCommand : System.ComponentModel.Component, IDisposable, System.Data.IDbCommand

type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable

Public MustInherit Class DbCommand
Inherits Component
Implements IDbCommand, IDisposable

Héritage

Object

MarshalByRefObject

Component

DbCommand

Dérivé

System.Data.EntityClient.EntityCommand

System.Data.Odbc.OdbcCommand

System.Data.OleDb.OleDbCommand

System.Data.OracleClient.OracleCommand

System.Data.SqlClient.SqlCommand

Implémente

IDisposable IDbCommand

Constructeurs

Nom	Description
DbCommand()	Construit une instance de l’objet DbCommand .

Propriétés

Nom	Description
CanRaiseEvents	Obtient une valeur indiquant si le composant peut déclencher un événement. (Hérité de Component)
CommandText	Obtient ou définit la commande de texte à exécuter sur la source de données.
CommandTimeout	Obtient ou définit le temps d’attente (en secondes) avant de terminer la tentative d’exécution de la commande et de générer une erreur.
CommandType	Obtient ou définit la façon dont la CommandText propriété est interprétée.
Connection	Obtient ou définit l’utilisé DbConnection par ce DbCommand.
Container	Obtient le IContainer fichier qui contient le Component. (Hérité de Component)
DbConnection	Obtient ou définit l’utilisé DbConnection par ce DbCommand.
DbParameterCollection	Obtient la collection d’objets DbParameter .
DbTransaction	Obtient ou définit l’objet DbTransaction dans lequel cet DbCommand objet s’exécute.
DesignMode	Obtient une valeur qui indique si la Component valeur est actuellement en mode création. (Hérité de Component)
DesignTimeVisible	Obtient ou définit une valeur indiquant si l’objet de commande doit être visible dans un contrôle d’interface personnalisé.
Events	Obtient la liste des gestionnaires d’événements qui sont attachés à ce Component. (Hérité de Component)
Parameters	Obtient la collection d’objets DbParameter . Pour plus d’informations sur les paramètres, consultez Configuration des paramètres et des types de données de paramètres.
Site	Obtient ou définit le ISite de Component. (Hérité de Component)
Transaction	Obtient ou définit l’objet DbTransaction dans lequel cet DbCommand objet s’exécute.
UpdatedRowSource	Obtient ou définit la façon dont les résultats de commande sont appliqués au DataRow moment utilisé par la méthode Update d’un DbDataAdapter.

Méthodes

Nom	Description
Cancel()	Tente d’annuler l’exécution d’un DbCommand.
CreateDbParameter()	Crée une instance d’un DbParameter objet.
CreateObjRef(Type)	Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject)
CreateParameter()	Crée une instance d’un DbParameter objet.
Dispose()	Libère toutes les ressources utilisées par le Component. (Hérité de Component)
Dispose(Boolean)	Libère les ressources non managées utilisées par les Component ressources gérées et libère éventuellement les ressources managées. (Hérité de Component)
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
ExecuteDbDataReader(CommandBehavior)	Exécute la commande sur sa connexion, en retournant une DbDataReader option qui peut être utilisée pour accéder aux résultats.
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Les fournisseurs doivent implémenter cette méthode pour fournir une implémentation non par défaut pour ExecuteReader les surcharges. L’implémentation par défaut appelle la méthode synchrone ExecuteReader() et retourne une tâche terminée, bloquant le thread appelant. L’implémentation par défaut retourne une tâche annulée si elle a passé un jeton d’annulation déjà annulé. Les exceptions levées par ExecuteReader sont communiquées via la propriété Exception de tâche retournée. Cette méthode accepte un jeton d’annulation qui peut être utilisé pour demander l’annulation anticipée de l’opération. Les implémentations peuvent ignorer cette demande.
ExecuteNonQuery()	Exécute la commande sur son objet de connexion, en retournant le nombre de lignes affectées.
ExecuteNonQueryAsync()	Version asynchrone de ExecuteNonQuery(), qui exécute la commande sur son objet de connexion, retournant le nombre de lignes affectées. ExecuteNonQueryAsync(CancellationToken) Appelle avec CancellationToken.None.
ExecuteNonQueryAsync(CancellationToken)	Il s’agit de la version asynchrone de ExecuteNonQuery(). Les fournisseurs doivent remplacer par une implémentation appropriée. Le jeton d’annulation peut éventuellement être ignoré. L’implémentation par défaut appelle la méthode synchrone ExecuteNonQuery() et retourne une tâche terminée, bloquant le thread appelant. L’implémentation par défaut retourne une tâche annulée si elle a passé un jeton d’annulation déjà annulé. Les exceptions levées par ExecuteNonQuery() seront communiquées via la propriété Exception de tâche retournée. N’appelez pas d’autres méthodes et propriétés de l’objet DbCommand tant que la tâche retournée n’est pas terminée.
ExecuteReader()	Exécute la commande sur sa connexion, en retournant une DbDataReader option qui peut être utilisée pour accéder aux résultats.
ExecuteReader(CommandBehavior)	Exécute la commande sur sa connexion, en retournant une DbDataReader option qui peut être utilisée pour accéder aux résultats.
ExecuteReaderAsync()	Version asynchrone de ExecuteReader, qui exécute la commande sur sa connexion, retournant une DbDataReader version qui peut être utilisée pour accéder aux résultats. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Appelle avec CancellationToken.None.
ExecuteReaderAsync(CancellationToken)	Version asynchrone de ExecuteReader, qui exécute la commande sur sa connexion, retournant une DbDataReader version qui peut être utilisée pour accéder aux résultats. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Appelle .
ExecuteReaderAsync(CommandBehavior, CancellationToken)	ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Appelle .
ExecuteReaderAsync(CommandBehavior)	Version asynchrone de ExecuteReader, qui exécute la commande sur sa connexion, retournant une DbDataReader version qui peut être utilisée pour accéder aux résultats. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Appelle .
ExecuteScalar()	Exécute la commande et retourne la première colonne de la première ligne du premier jeu de résultats retourné. Toutes les autres colonnes, lignes et jeux de résultats sont ignorés.
ExecuteScalarAsync()	Version asynchrone de ExecuteScalar(), qui exécute la commande et retourne la première colonne de la première ligne dans le premier jeu de résultats retourné. Toutes les autres colonnes, lignes et jeux de résultats sont ignorés. ExecuteScalarAsync(CancellationToken) Appelle avec CancellationToken.None.
ExecuteScalarAsync(CancellationToken)	Il s’agit de la version asynchrone de ExecuteScalar(). Les fournisseurs doivent remplacer par une implémentation appropriée. Le jeton d’annulation peut éventuellement être ignoré. L’implémentation par défaut appelle la méthode synchrone ExecuteScalar() et retourne une tâche terminée, bloquant le thread appelant. L’implémentation par défaut retourne une tâche annulée si elle a passé un jeton d’annulation déjà annulé. Les exceptions levées par ExecuteScalar sont communiquées via la propriété Exception de tâche retournée. N’appelez pas d’autres méthodes et propriétés de l’objet DbCommand tant que la tâche retournée n’est pas terminée.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Récupère l’objet de service de durée de vie actuel qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetService(Type)	Retourne un objet qui représente un service fourni par le Component ou par son Container. (Hérité de Component)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l’objet actuel MarshalByRefObject . (Hérité de MarshalByRefObject)
Prepare()	Crée une version préparée (ou compilée) de la commande sur la source de données.
ToString()	Retourne un String nom contenant le nom du Component, le cas échéant. Cette méthode ne doit pas être remplacée. (Hérité de Component)

Événements

Nom	Description
Disposed	Se produit lorsque le composant est supprimé par un appel à la Dispose() méthode. (Hérité de Component)

Implémentations d’interfaces explicites

Nom	Description
IDbCommand.Connection	Obtient ou définit l’utilisé IDbConnection par cette instance du IDbCommand.
IDbCommand.CreateParameter()	Crée une instance d’un IDbDataParameter objet.
IDbCommand.ExecuteReader()	Exécute l’objet CommandText sur le Connection fichier et génère un IDataReader.
IDbCommand.ExecuteReader(CommandBehavior)	Exécute la valeur par rapport à CommandText l’élément , et génère une Connection opération à l’aide IDataReaderde l’une CommandBehavior des valeurs.
IDbCommand.Parameters	Obtient le IDataParameterCollection.
IDbCommand.Transaction	Obtient ou définit l’objet DbTransaction dans lequel cet DbCommand objet s’exécute.

Voir aussi

• Vue d'ensemble d’ADO.NET