Partage via


DbCommand Classe

Définition

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 : IDisposable
public ref class DbCommand abstract : System::ComponentModel::Component, IAsyncDisposable, IDisposable, System::Data::IDbCommand
public ref class DbCommand abstract : IDisposable, System::Data::IDbCommand
public ref class DbCommand abstract : System::ComponentModel::Component, IDisposable, System::Data::IDbCommand
public ref class DbCommand abstract : System::ComponentModel::Component, System::Data::IDbCommand
public ref class DbCommand abstract : System::ComponentModel::Component, IAsyncDisposable, System::Data::IDbCommand
public abstract class DbCommand : IDisposable
public abstract class DbCommand : System.ComponentModel.Component, IAsyncDisposable, IDisposable, System.Data.IDbCommand
public abstract class DbCommand : IDisposable, System.Data.IDbCommand
public abstract class DbCommand : System.ComponentModel.Component, IDisposable, System.Data.IDbCommand
public abstract class DbCommand : System.ComponentModel.Component, System.Data.IDbCommand
public abstract class DbCommand : System.ComponentModel.Component, IAsyncDisposable, System.Data.IDbCommand
type DbCommand = class
    interface IDisposable
type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
    interface IAsyncDisposable
type DbCommand = class
    interface IDbCommand
    interface IDisposable
type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
Public MustInherit Class DbCommand
Implements IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IAsyncDisposable, IDbCommand, IDisposable
Public MustInherit Class DbCommand
Implements IDbCommand, IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IDbCommand, IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IDbCommand
Public MustInherit Class DbCommand
Inherits Component
Implements IAsyncDisposable, IDbCommand
Héritage
DbCommand
Héritage
Dérivé
Implémente

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

Effectue des tâches définies par l’application associées à la libération, à la libération ou à la réinitialisation des ressources non managées.

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 DbCommand et libère éventuellement les ressources managées.

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 une chaîne qui représente l’objet actuel.

(Hérité de Object)
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.

S’applique à

Voir aussi