CommandBehavior Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit une description des résultats de la requête et de son effet 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
- Attributs
Champs
| Nom | Valeur | Description |
|---|---|---|
| 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.
|
| SingleResult | 1 | La requête retourne un jeu de résultats unique. |
| SchemaOnly | 2 | La requête retourne uniquement les informations de colonne. Lorsque vous utilisez SchemaOnly, le .NET Framework Fournisseur de données pour SQL Server précède l’instruction exécutée avec SET FMTONLY ON. |
| KeyInfo | 4 | La requête retourne les informations de colonne et de clé primaire. Le fournisseur ajoute des colonnes supplémentaires au jeu de résultats pour les colonnes de clé primaire et d’horodatage existantes. |
| SingleRow | 8 | La requête est censée retourner une seule ligne 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, mais ne sont pas requis, 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 Framework .NET pour OLE DB effectue une liaison à l’aide de l’interface OLE DB |
| SequentialAccess | 16 | Fournit un moyen de |
| CloseConnection | 32 | Lorsque la commande est exécutée, l’objet associé |
Remarques
Les CommandBehavior valeurs sont utilisées par la ExecuteReader méthode de IDbCommand et toutes les classes qui implémentent IDbCommand.
Une combinaison binaire de ces valeurs peut être utilisée.
CommandBehavior est ignoré lorsqu'il est utilisé pour définir un SqlNotificationRequest ou un SqlDependency, il ne doit donc pas être utilisé. Utilisez le constructeur qui ne nécessite pas de CommandBehavior paramètre dans ces deux cas.
Remarques sur les membres d’énumération individuels
Lors de l’utilisation KeyInfo, le fournisseur de données .NET Framework pour SQL Server précède l’exécution de l’instruction avec SET FMTONLY OFF et SET NO_BROWSETABLE ON. Les utilisateurs doivent être conscients des effets secondaires potentiels, tels que l’interférence avec l’utilisation des instructions SET FMTONLY ON. Pour plus d’informations, consultez SET FMTONLY (Transact-SQL).
Note
Permet SequentialAccess de récupérer des valeurs volumineuses et des données binaires. Sinon, un OutOfMemoryException pourrait se produire et la connexion sera fermée.
Lorsque vous spécifiez SequentialAccess, vous devez lire à partir des colonnes dans l’ordre dans lequel elles sont retournées, même si vous n’êtes pas obligé de lire chaque colonne. Une fois que vous avez dépassé un emplacement dans le flux de données retourné, les données à ou avant cet emplacement ne peuvent plus être lues à partir du DataReader. Lorsque vous utilisez OleDbDataReader, vous pouvez relire la valeur de la colonne actuelle jusqu’à ce que vous la dépassiez. Lorsque vous utilisez le SqlDataReaderfichier , vous ne pouvez lire une valeur de colonne qu’une seule fois.
