Compartir a través de


CommandBehavior Enumeración

Definición

Proporciona una descripción de los resultados de la consulta y su efecto en la base de datos.

Esta enumeración admite una combinación bit a bit de sus valores de miembro.

public enum class CommandBehavior
[System.Flags]
public enum CommandBehavior
[<System.Flags>]
type CommandBehavior = 
Public Enum CommandBehavior
Herencia
CommandBehavior
Atributos

Campos

CloseConnection 32

Al ejecutar el comando, se cerrará el objeto Connection asociado cuando se cierre el objeto DataReader asociado.

Default 0

La consulta puede devolver varios conjuntos de resultados. La ejecución de la consulta puede afectar al estado de la base de datos. Default no establece ninguna marca CommandBehavior, por lo que llamar a ExecuteReader(CommandBehavior.Default) equivale funcionalmente a llamar a ExecuteReader().

KeyInfo 4

La consulta devuelve información sobre la columna y la clave principal. El proveedor anexa columnas adicionales al conjunto de resultados para las columnas de clave principal y marca de tiempo existentes.

SchemaOnly 2

La consulta sólo devuelve información de columna. Al utilizar SchemaOnly, el proveedor de datos de .NET Framework para SQL Server hace que la instrucción que está ejecutando vaya precedida de SET FMTONLY ON.

SequentialAccess 16

Proporciona un modo para que el DataReader controle las filas que contienen columnas con valores binarios grandes. En lugar de cargar la fila completa, SequentialAccess permite al DataReader cargar datos como una secuencia. A continuación, se pueden utilizar los métodos GetBytes o GetChars para especificar una ubicación de bytes donde iniciar la operación de lectura, así como un tamaño de búfer limitado para los datos devueltos.

SingleResult 1

La consulta devuelve un único conjunto de resultados.

SingleRow 8

Se espera que la consulta devuelva una fila única del primer conjunto de resultados. La ejecución de la consulta puede afectar al estado de la base de datos. Aunque no es necesario, algunos proveedores de datos .NET pueden utilizar esta información para optimizar el rendimiento del comando. Al especificar SingleRow con el método ExecuteReader() del objeto OleDbCommand, el proveedor de datos de .NET Framework para OLE DB realiza el enlace mediante la interfaz IRow de OLE DB, si se encuentra disponible. En caso contrario, utiliza la interfaz IRowset. Además, si se espera que la instrucción SQL devuelva una única fila, se puede mejorar el rendimiento de la aplicación especificando SingleRow. Es posible especificar SingleRow al ejecutar consultas que se espera que devuelvan varios conjuntos de resultados. En ese caso, cuando se especifican una consulta SQL con varios conjuntos de resultados y una sola fila, el resultado devuelto contendrá solo la primera fila del primer conjunto de resultados. No se devolverán los demás conjuntos de resultados de la consulta.

Comentarios

Para obtener más información sobre esta API, consulte Comentarios complementarios de la API para CommandBehavior.

Se aplica a