Cette énumération possède un attribut FlagsAttribute qui permet la combinaison d'opérations de bits de ses valeurs membres.
Espace de noms : System.DataAssembly : System.Data (dans system.data.dll)
Syntaxe<FlagsAttribute> _
Public Enumeration CommandBehavior
Dim instance As CommandBehavior
[FlagsAttribute]
public enum CommandBehavior
[FlagsAttribute] public enum class CommandBehavior
/** @attribute FlagsAttribute() */
public enum CommandBehavior
FlagsAttribute
public enum CommandBehavior
Membres| Nom de membre | Description | |
|---|---|---|
![]() | CloseConnection | Lorsque la commande est exécutée, l'objet Connection associé se ferme en même temps que l'objet DataReader. |
![]() | Default | 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. Par conséquent, l'appel à ExecuteReader(CommandBehavior.Default) équivaut fonctionnellement à l'appel à ExecuteReader(). |
![]() | KeyInfo | La requête retourne des informations de colonne et de clé primaire. Lorsque KeyInfo est utilisé pour l'exécution de commande, le fournisseur ajoutera des colonnes supplémentaires au jeu de résultats pour la clé primaire existante et des colonnes d'horodatage. Lors de l'utilisation de KeyInfo, le fournisseur de données .NET Framework pour SQL Server fait précéder l'instruction en cours d'exécution par SET FMTONLY OFF et SET NO_BROWSETABLE ON. L'utilisateur doit connaître les effets secondaires potentiels, tels que les interférences avec l'utilisation d'instructions SET FMTONLY ON. Pour plus d'informations, consultez la documentation en ligne de SQL Server. |
![]() | SchemaOnly | 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 | 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. Lorsque vous spécifiez SequentialAccess, vous êtes obligé de lire les colonnes dans l'ordre où elles sont retournées, mais il n'est cependant pas nécessaire de lire chaque colonne. Lorsque vous avez lu au-delà d'un emplacement du flux de données retourné, les données situées jusqu'à cet emplacement ne peuvent plus être lues à partir de DataReader. Si vous utilisez OleDbDataReader, vous pouvez relire la valeur de la colonne en cours jusqu'à ce que vous lisiez au-delà de celle-ci. Si vous utilisez SqlDataReader, une valeur de colonne peut être lue à une seule reprise. |
![]() | SingleResult | La requête retourne un jeu de résultat unique. |
![]() | SingleRow | La requête retourne normalement une ligne unique. L'exécution de la requête peut affecter l'état de la base de données. Certains fournisseurs de données .NET Framework peuvent éventuellement utiliser ces informations pour optimiser les performances 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 lorsque vous exécutez des requêtes qui retournent plusieurs jeux de résultats. Dans ce cas, plusieurs jeux de résultats sont toujours retournés, mais chaque jeu possède une ligne unique. |
NotesLes valeurs CommandBehavior sont utilisées par la méthode ExecuteReader de IDbCommand et toutes les classes qui en sont dérivées.
Une combinaison d'opérations de bits de ces valeurs peut être utilisée.
Plates-formesWindows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.
Informations de version
Outils (masquer)
S'enregistrer
Liste des Membres
Qui est en ligne?
FAQ