CommandBehavior CommandBehavior CommandBehavior CommandBehavior Enum

Definición

Proporciona una descripción de los resultados de la consulta y de sus efectos en la base de datos.Provides a description of the results of the query and its effect on the database.

Esta enumeración tiene el atributo FlagsAttribute, que permite una combinación bit a bit de sus valores de miembro.

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

Campos

CloseConnection CloseConnection CloseConnection CloseConnection 32

Al ejecutar el comando, se cerrará el objeto Connection asociado cuando se cierre el objeto DataReader asociado.When the command is executed, the associated Connection object is closed when the associated DataReader object is closed.

Default Default Default Default 0

La consulta puede devolver varios conjuntos de resultados.The query may return multiple result sets. La ejecución de la consulta puede afectar al estado de la base de datos.Execution of the query may affect the database state. Default no establece ninguna marca CommandBehavior, por lo que llamar a ExecuteReader(CommandBehavior.Default) equivale funcionalmente a llamar a ExecuteReader().Default sets no CommandBehavior flags, so calling ExecuteReader(CommandBehavior.Default) is functionally equivalent to calling ExecuteReader().

KeyInfo KeyInfo KeyInfo KeyInfo 4

La consulta devuelve información sobre la columna y la clave principal.The query returns column and primary key information. El proveedor anexa columnas adicionales al conjunto de resultados para las columnas de clave principal y marca de tiempo existentes.The provider appends extra columns to the result set for existing primary key and timestamp columns.

SchemaOnly SchemaOnly SchemaOnly SchemaOnly 2

La consulta sólo devuelve información de columna.The query returns column information only. 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.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

Proporciona un modo para que el DataReader controle las filas que contienen columnas con valores binarios grandes.Provides a way for the DataReader to handle rows that contain columns with large binary values. En lugar de cargar la fila completa, SequentialAccess permite al DataReader cargar datos como una secuencia.Rather than loading the entire row, SequentialAccess enables the DataReader to load data as a stream. 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.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 consulta devuelve un único conjunto de resultados.The query returns a single result set.

SingleRow SingleRow SingleRow SingleRow 8

Se espera que la consulta devuelva una fila única del primer conjunto de resultados.The query is expected to return a single row of the first result set. La ejecución de la consulta puede afectar al estado de la base de datos.Execution of the query may affect the database state. Aunque no es necesario, algunos proveedores de datos de .NET Framework pueden utilizar esta información para optimizar el rendimiento del comando.Some .NET Framework data providers may, but are not required to, use this information to optimize the performance of the command. 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.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. En caso contrario, utiliza la interfaz IRowset.Otherwise, it uses the IRowset interface. 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.If your SQL statement is expected to return only a single row, specifying SingleRow can also improve application performance. Es posible especificar SingleRow al ejecutar consultas que se espera que devuelvan varios conjuntos de resultados.It is possible to specify SingleRow when executing queries that are expected to return multiple result sets. 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.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. No se devolverán los demás conjuntos de resultados de la consulta.The other result sets of the query will not be returned.

Comentarios

Los valores son utilizados por el ExecuteReader método de IDbCommand y cualquier clase de implementación. CommandBehaviorThe CommandBehavior values are used by the ExecuteReader method of IDbCommand and any implementing classes.

Se puede usar una combinación bit a bit de estos valores.A bitwise combination of these values may be used.

CommandBehaviorse omite cuando se usa para definir SqlNotificationRequest un SqlDependency o y, por tanto, no se debe usar.CommandBehavior is ignored when used to define a SqlNotificationRequest or SqlDependency and should therefore not be used. Use el constructor que no requiera un CommandBehavior parámetro en estos dos casos.Use the constructor that does not require a CommandBehavior parameter in these two cases.

Notas sobre miembros de enumeración individualesNotes on individual enumeration members

Al utilizar KeyInfo, el proveedor de datos de .NET Framework para SQL Server precede a la instrucción SET FMTONLY OFF que SET NO_BROWSETABLE ONse ejecuta con y.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. El usuario debe tener en cuenta los posibles efectos secundarios, como la interferencia con el uso SET FMTONLY ON de instrucciones.The user should be aware of potential side effects, such as interference with the use of SET FMTONLY ON statements. Para obtener más información, vea SET FMTONLY (Transact-SQL).For more information, see SET FMTONLY (Transact-SQL).

Nota

Use SequentialAccess para recuperar valores grandes y datos binarios.Use SequentialAccess to retrieve large values and binary data. De lo contrario OutOfMemoryException , podría producirse una excepción y se cerrará la conexión.Otherwise, an OutOfMemoryException might occur and the connection will be closed.

Al especificar SequentialAccess, es necesario leer las columnas en el orden en que se devuelven, aunque no es necesario leer cada columna.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. Una vez que haya leído más allá de una ubicación en el flujo de datos devuelto, los DataReaderdatos en o antes de esa ubicación ya no se podrán leer de.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. Al usar OleDbDataReader, puede releer el valor de la columna actual hasta que lo haya leído.When using the OleDbDataReader, you can reread the current column value until reading past it. Al usar SqlDataReader, puede leer un valor de columna una sola vez.When using the SqlDataReader, you can read a column value only once.

Se aplica a