CommandBehavior (Enumeración)
Actualización: noviembre 2007
Proporciona una descripción de los resultados de la consulta y de sus efectos en la base de datos.
Esta enumeración tiene un atributo FlagsAttribute que permite una combinación bit a bit de los valores de miembro.
Espacio de nombres: System.DataEnsamblado: System.Data (en System.Data.dll)
| Nombre de miembro | Descripción | |
|---|---|---|
|
Default | 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 marcadores CommandBehavior, por lo que una llamada a ExecuteReader(CommandBehavior.Default) es equivalente en términos funcionales a una llamada a ExecuteReader(). |
|
|
SingleResult | La consulta devuelve un único conjunto de resultados. |
|
|
SchemaOnly | 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. |
|
|
KeyInfo | La consulta devuelve información sobre la columna y la clave principal. |
|
|
SingleRow | Se espera que la consulta devuelva una única fila. La ejecución de la consulta puede afectar al estado de la base de datos. Aunque no es necesario, algunos proveedores de datos de .NET Framework 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 devuelven varios conjuntos de resultados. En ese caso, se seguirán devolviendo varios conjuntos de resultados, aunque cada uno de ellos constará de una única fila. |
|
|
SequentialAccess | 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. |
|
|
CloseConnection | Al ejecutar el comando, se cerrará el objeto Connection asociado cuando se cierre el objeto DataReader asociado. |
Los valores CommandBehavior se utilizan en el método ExecuteReader de IDbCommand y en cualquiera de sus clases derivadas.
Se puede utilizar una combinación bit a bit de estos valores.
CommandBehavior se omite cuando se utiliza para definir un objeto SqlNotificationRequest o un objeto SqlDependency y, por lo tanto, no se debe utilizar. Utilice el constructor que no requiere un parámetro CommandBehavior en estos dos casos.
Nota:
|
|---|
|
Use SequentialAccess para recuperar valores grandes y datos binarios. De lo contrario, puede producirse una excepción OutOfMemoryException y se cerrará la conexión. |
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC, Xbox 360
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
