CommandBehavior CommandBehavior CommandBehavior CommandBehavior Enum

Définition

Fournit une description des résultats de la requête et de ses effets sur la base de données.Provides a description of the results of the query and its effect on the database.

Cette énumération a un attribut FlagsAttribute qui permet une combinaison au niveau du bit de ses valeurs membres.

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

Champs

CloseConnection CloseConnection CloseConnection CloseConnection 32

Lorsque la commande est exécutée, l'objet Connection associé se ferme en même temps que l'objet DataReader.When the command is executed, the associated Connection object is closed when the associated DataReader object is closed.

Default Default Default Default 0

La requête peut retourner plusieurs jeux de résultats.The query may return multiple result sets. L'exécution de la requête peut affecter l'état de la base de données.Execution of the query may affect the database state. Default ne définit aucun indicateur CommandBehavior, le fait d'appeler ExecuteReader(CommandBehavior.Default) équivaut donc à appeler ExecuteReader().Default sets no CommandBehavior flags, so calling ExecuteReader(CommandBehavior.Default) is functionally equivalent to calling ExecuteReader().

KeyInfo KeyInfo KeyInfo KeyInfo 4

La requête retourne des informations de colonne et de clé primaire.The query returns column and primary key information. Le fournisseur ajoute des colonnes supplémentaires au jeu de résultats pour les colonnes clé primaire et timestamp existantes.The provider appends extra columns to the result set for existing primary key and timestamp columns.

SchemaOnly SchemaOnly SchemaOnly SchemaOnly 2

La requête retourne uniquement des informations sur la colonne.The query returns column information only. 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.When using SchemaOnly, the .NET Framework Data Provider for SQL Server precedes the statement being executed with SET FMTONLY ON.

SequentialAccess SequentialAccess SequentialAccess SequentialAccess 16

Fournit à DataReader un moyen de gérer les lignes qui contiennent des colonnes renfermant des valeurs binaires élevées.Provides a way for the DataReader to handle rows that contain columns with large binary values. Plutôt que de charger la ligne entière, SequentialAccess permet à DataReader de charger les données en tant que flux.Rather than loading the entire row, SequentialAccess enables the DataReader to load data as a stream. 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.You can then use the GetBytes or GetChars method to specify a byte location to start the read operation, and a limited buffer size for the data being returned.

SingleResult SingleResult SingleResult SingleResult 1

La requête retourne un jeu de résultat unique.The query returns a single result set.

SingleRow SingleRow SingleRow SingleRow 8

La requête est supposée retourner une ligne unique du premier jeu de résultats.The query is expected to return a single row of the first result set. L'exécution de la requête peut affecter l'état de la base de données.Execution of the query may affect the database state. Certains fournisseurs de données .NET Framework peuvent éventuellement utiliser ces informations pour optimiser les performances de la commande.Some .NET Framework data providers may, but are not required to, use this information to optimize the performance of the command. 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.When you specify SingleRow with the ExecuteReader() method of the OleDbCommand object, the .NET Framework Data Provider for OLE DB performs binding using the OLE DB IRow interface if it is available. Sinon, il utilise l'interface IRowset.Otherwise, it uses the IRowset interface. Si votre instruction SQL doit normalement retourner une seule ligne, la spécification de SingleRow peut également améliorer les performances de l'application.If your SQL statement is expected to return only a single row, specifying SingleRow can also improve application performance. 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.It is possible to specify SingleRow when executing queries that are expected to return multiple result sets. 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.In that case, where both a multi-result set SQL query and single row are specified, the result returned will contain only the first row of the first result set. Les autres jeux de résultats de la requête ne seront pas retournés.The other result sets of the query will not be returned.

Remarques

Le CommandBehavior valeurs sont utilisées par le ExecuteReader méthode de IDbCommand et les classes d’implémentation.The CommandBehavior values are used by the ExecuteReader method of IDbCommand and any implementing classes.

Une combinaison au niveau du bit des valeurs suivantes peut être utilisée.A bitwise combination of these values may be used.

CommandBehavior est ignoré lorsqu’il est utilisé pour définir un SqlNotificationRequest ou SqlDependency et doit par conséquent pas être utilisé.CommandBehavior is ignored when used to define a SqlNotificationRequest or SqlDependency and should therefore not be used. Utilisez le constructeur qui ne nécessite pas un CommandBehavior paramètre dans ces deux cas.Use the constructor that does not require a CommandBehavior parameter in these two cases.

Remarques sur les membres de l’énumération individuellesNotes on individual enumeration members

Lorsque vous utilisez KeyInfo, le fournisseur de données .NET Framework pour SQL Server fait précéder l’instruction en cours d’exécution avec SET FMTONLY OFF et SET NO_BROWSETABLE ON.When using KeyInfo, the .NET Framework Data Provider for SQL Server precedes the statement being executed with SET FMTONLY OFF and SET NO_BROWSETABLE ON. L’utilisateur doit être conscient des effets secondaires potentiels, tels que les interférences avec l’utilisation de SET FMTONLY ON instructions.The user should be aware of potential side effects, such as interference with the use of SET FMTONLY ON statements. Pour plus d’informations, consultez SET FMTONLY (Transact-SQL).For more information, see SET FMTONLY (Transact-SQL).

Notes

Utilisez SequentialAccess pour récupérer des valeurs élevées et des données binaires.Use SequentialAccess to retrieve large values and binary data. Sinon, un OutOfMemoryException peut se produire et la connexion va être fermée.Otherwise, an OutOfMemoryException might occur and the connection will be closed.

Lorsque vous spécifiez SequentialAccess, vous êtes invité à lire les colonnes dans l’ordre où elles sont retournées, même si vous n’êtes pas obligé de lire chaque colonne.When you specify SequentialAccess, you are required to read from the columns in the order they are returned, although you are not required to read each column. Une fois que vous avez lu au-delà d’un emplacement dans le flux de données retourné, les données à ou avant cet emplacement n’est plus peuvent être lues qu’à partir de la DataReader.Once you have read past a location in the returned stream of data, data at or before that location can no longer be read from the DataReader. Lorsque vous utilisez le OleDbDataReader, vous pouvez relire la valeur actuelle de la colonne jusqu'à ce que de lecture au-delà de celle-ci.When using the OleDbDataReader, you can reread the current column value until reading past it. Lorsque vous utilisez le SqlDataReader, vous pouvez lire une valeur de colonne qu’une seule fois.When using the SqlDataReader, you can read a column value only once.

S’applique à