DbCommand Classe

Définition

Espace de noms:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DbCommand.cs

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, IAsyncDisposable, IDisposable, System::Data::IDbCommand

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

type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
    interface IAsyncDisposable

Public MustInherit Class DbCommand
Inherits Component
Implements IAsyncDisposable, IDbCommand, IDisposable

Héritage

Object

MarshalByRefObject

Component

DbCommand

Dérivé

System.Data.EntityClient.EntityCommand

System.Data.Odbc.OdbcCommand

System.Data.OleDb.OleDbCommand

System.Data.SqlClient.SqlCommand

Implémente

IDisposable IDbCommand IAsyncDisposable

Constructeurs

DbCommand()

Construit une instance de l’objet DbCommand.

Propriétés

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 propriété CommandText est interprétée.
Connection	Obtient ou définit la DbConnection utilisée par cette DbCommand.
Container	Obtient le IContainer qui contient le Component. (Hérité de Component)
DbConnection	Obtient ou définit la DbConnection utilisée par cette DbCommand.
DbParameterCollection	Obtient la collection d’objets DbParameter.
DbTransaction	Obtient ou définit la DbTransaction dans laquelle cet objet DbCommand s’exécute.
DesignMode	Obtient une valeur qui indique si le Component 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 à cette 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 la ISite du Component. (Hérité de Component)
Transaction	Obtient ou définit la DbTransaction dans laquelle cet objet DbCommand s’exécute.
UpdatedRowSource	Obtient ou définit la façon dont les résultats de commande sont appliqués à l'DataRow lorsqu’ils sont utilisés par la méthode Update d’un DbDataAdapter.

Méthodes

Cancel()	Tente d’annuler l’exécution d’un DbCommand.
CreateDbParameter()	Crée une instance d’un objet DbParameter.
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 objet DbParameter.
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 le Component et libère éventuellement les ressources managées. (Hérité de Component)
DisposeAsync()	Dipose de façon asynchrone l’objet de commande.
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, retournant une DbDataReader 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 surcharges. L’implémentation par défaut appelle la méthode de ExecuteReader() synchrone 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. Appelle ExecuteNonQueryAsync(CancellationToken) 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 de ExecuteNonQuery() synchrone 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() 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.
ExecuteReader()	Exécute la commande sur sa connexion, retournant une DbDataReader qui peut être utilisée pour accéder aux résultats.
ExecuteReader(CommandBehavior)	Exécute la commande sur sa connexion, retournant une DbDataReader 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 qui peut être utilisée pour accéder aux résultats. Appelle ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) avec CancellationToken.None.
ExecuteReaderAsync(CancellationToken)	Version asynchrone de ExecuteReader, qui exécute la commande sur sa connexion, retournant une DbDataReader qui peut être utilisée pour accéder aux résultats. Appelle ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).
ExecuteReaderAsync(CommandBehavior)	Version asynchrone de ExecuteReader, qui exécute la commande sur sa connexion, retournant une DbDataReader qui peut être utilisée pour accéder aux résultats. Appelle ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Appelle ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).
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 du premier jeu de résultats retourné. Toutes les autres colonnes, lignes et jeux de résultats sont ignorés. Appelle ExecuteScalarAsync(CancellationToken) 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 de ExecuteScalar() synchrone 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()	Obsolète. 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)	Renvoie un objet qui représente un service fourni par l'Component ou par son Container. (Hérité de Component)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obsolète. 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 MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
Prepare()	Crée une version préparée (ou compilée) de la commande sur la source de données.
PrepareAsync(CancellationToken)	Crée de façon asynchrone une version préparée (ou compilée) de la commande sur la source de données.
ToString()	Retourne un String contenant le nom du Component, le cas échéant. Cette méthode ne doit pas être remplacée. (Hérité de Component)

Événements

Disposed

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

Implémentations d’interfaces explicites

IDbCommand.Connection	Obtient ou définit la IDbConnection utilisée par cette instance du IDbCommand.
IDbCommand.CreateParameter()	Crée une instance d’un objet IDbDataParameter.
IDbCommand.ExecuteReader()	Exécute la CommandText sur le Connection et génère une IDataReader.
IDbCommand.ExecuteReader(CommandBehavior)	Exécute le CommandText sur le Connectionet génère un IDataReader à l’aide de l’une des valeurs CommandBehavior.
IDbCommand.Parameters	Obtient le IDataParameterCollection.
IDbCommand.Transaction	Obtient ou définit la DbTransaction dans laquelle cet objet DbCommand s’exécute.

Méthodes d’extension

ConfigureAwait(IAsyncDisposable, Boolean)

Configure la façon dont les attentes sur les tâches retournées à partir d’un jetable asynchrone sont effectuées.

Voir aussi

• ADO.NET Vue d’ensemble