Partage via


CommandBehavior Énumération

Définition

Fournit une description des résultats de la requête et de ses effets sur la base de données.

Cette énumération prend en charge une combinaison au niveau du bit de ses valeurs membres.

public enum class CommandBehavior
[System.Flags]
public enum CommandBehavior
[<System.Flags>]
type CommandBehavior = 
Public Enum CommandBehavior
Héritage
CommandBehavior
Attributs

Champs

CloseConnection 32

Lorsque la commande est exécutée, l'objet Connection associé se ferme en même temps que l'objet DataReader.

Default 0

La requête peut retourner plusieurs jeux de résultats. L'exécution de la requête peut affecter l'état de la base de données. Default ne définit aucun indicateur CommandBehavior, le fait d'appeler ExecuteReader(CommandBehavior.Default) équivaut donc à appeler ExecuteReader().

KeyInfo 4

La requête retourne des informations de colonne et de clé primaire. Le fournisseur ajoute des colonnes supplémentaires au jeu de résultats pour les colonnes clé primaire et timestamp existantes.

SchemaOnly 2

La requête retourne uniquement des informations sur la colonne. Lors de l'utilisation de SchemaOnly, le fournisseur de données .NET Framework pour SQL Server fait précéder l'instruction en cours d'exécution par SET FMTONLY ON.

SequentialAccess 16

Fournit à DataReader un moyen de gérer les lignes qui contiennent des colonnes renfermant des valeurs binaires élevées. Plutôt que de charger la ligne entière, SequentialAccess permet à DataReader de charger les données en tant que flux. Vous pouvez ensuite utiliser la méthode GetBytes ou GetChars afin de spécifier un emplacement d'octets à partir duquel démarrer l'opération de lecture, ainsi qu'une taille de mémoire tampon limitée pour les données retournées.

SingleResult 1

La requête retourne un jeu de résultat unique.

SingleRow 8

La requête est supposée retourner une ligne unique du premier jeu de résultats. L'exécution de la requête peut affecter l'état de la base de données. Certains fournisseurs de données .NET peuvent éventuellement utiliser ces informations pour optimiser le niveau de performance de la commande. Lorsque vous spécifiez SingleRow avec la méthode ExecuteReader() de l'objet OleDbCommand, le fournisseur de données .NET Framework pour OLE DB effectue la liaison à l'aide de l'interface IRow OLE DB si elle est disponible. Sinon, il utilise l'interface IRowset. Si votre instruction SQL doit normalement retourner une seule ligne, la spécification de SingleRow peut également améliorer les performances de l'application. Il est possible de spécifier SingleRow lors de l'exécution de requêtes qui sont supposées retourner plusieurs jeux de résultats. Dans ce cas, où une requête SQL à plusieurs jeux de résultats et une ligne unique sont spécifiés, le résultat retourné contiendra uniquement la première ligne du premier jeu de résultats. Les autres jeux de résultats de la requête ne seront pas retournés.

Remarques

Pour plus d’informations sur cette API, consultez Remarques supplémentaires sur l’API pour CommandBehavior.

S’applique à