Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original. |
Traducción
Original
|
CommandBehavior (Enumeración)
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 ninguna marca CommandBehavior, por lo que llamar a ExecuteReader(CommandBehavior.Default) equivale funcionalmente a llamar 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.
Cuando se utiliza KeyInfo para la ejecución de comandos, el proveedor anexa columnas adicionales al conjunto de resultados para las columnas de marca de hora y clave principal existentes. Al utilizar KeyInfo, el proveedor de datos de .NET Framework para SQL Server hace que la instrucción que se está ejecutando vaya precedida de SET FMTONLY OFF y SET NO_BROWSETABLE ON. El usuario debe tener en cuenta los posibles efectos secundarios, como las interferencias con el uso de las instrucciones SET FMTONLY ON. Vea los Libros en pantalla de SQL Server para obtener más información. |
|
|
SingleRow | 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 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 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. |
|
|
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.
Si se especifica SequentialAccess, es necesario leer las columnas en el orden en el que se devuelven, pero no es necesario leer cada una de las columnas. Una vez que se lea una ubicación en el flujo de datos devuelto, no será posible volver a leer los datos de esa ubicación o de otra anterior desde el DataReader. Cuando se utiliza OleDbDataReader, se puede volver a leer el valor de la columna actual hasta que termine la lectura. Cuando se utiliza SqlDataReader, sólo se puede leer una vez el valor de una columna. |
|
|
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 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2
.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.