Parámetros y DataAdapter de DB2
La DataAdapter clase tiene cuatro propiedades que se usan para recuperar datos de y actualizar datos al origen de datos: la SelectCommand propiedad devuelve datos del origen de datos; las InsertCommandpropiedades , UpdateCommandy DeleteCommand se usan para administrar los cambios en el origen de datos. Debe establecer la SelectCommand propiedad antes de llamar al Fill método del DataAdapter objeto . Las propiedades InsertCommand, UpdateCommand o DeleteCommand se deben establecer antes llamar al método Update de DataAdapter, en función de las modificaciones realizadas en los datos en DataSet. Por ejemplo, si se han agregado filas, debe establecer la InsertCommand propiedad antes de llamar al Update método . Cuando Update se procesa una fila insertada, actualizada o eliminada, el DataAdapter objeto usa la propiedad respectiva Command para procesar la acción. La información actual relacionada con la fila modificada se pasa al objeto Command a través de la colección Parameters.
Al actualizar una fila en el origen de datos, se llama a la instrucción UPDATE, que usa un identificador único para identificar la fila de la tabla que se va a actualizar. El identificador único suele ser el valor de un campo de clave principal. La instrucción UPDATE usa parámetros que contienen el identificador único y las columnas y los valores que se van a actualizar.
Al especificar el Parameter tipo, se convierte el valor del parámetro en el Proveedor de datos administrados para DB2 antes de pasar el valor al origen de datos. También puede especificar el tipo de un de Parameter forma genérica estableciendo la DbType propiedad del Parameter objeto en un determinado DbType.
Valores de enumeración ParameterDirection
En la tabla siguiente se muestran los valores que puede usar con la ParameterDirection enumeración para establecer el Direction de Parameter.
| Nombre del miembro | Descripción |
|---|---|
| Entrada | Se trata de un parámetro de entrada. Este es el valor predeterminado. |
| InputOutput | El parámetro puede ser de entrada o de salida. |
| Resultados | Se trata de un parámetro de salida. |
| ReturnValue | El parámetro representa un valor devuelto. |
SourceColumn y SourceVersion se pueden pasar como argumentos al Parameter constructor o establecer como propiedades de un existente Parameter. SourceColumn es el nombre de DataColumn desde el DataRow donde se recupera el valor de .Parameter SourceVersion especifica la DataAdapter versión que DataRow usa para recuperar el valor.
Valores de enumeración DataRowVersion
En la tabla siguiente se muestran los valores de la enumeración DataRowVersion disponibles para su uso con SourceVersion.
| Nombre del miembro | Descripción |
|---|---|
| Current | El parámetro utiliza el valor actual de la columna. Este es el valor predeterminado. |
| Valor predeterminado | El parámetro usa defaultValue de la columna. |
| Original | El parámetro utiliza el valor original de la columna. |
| Propuesto | El parámetro utiliza un valor propuesto. |
Puede controlar cómo se asignan los valores devueltos desde el origen de datos al DataSet objeto mediante la UpdatedRowSource propiedad del Command objeto . Al establecer la UpdatedRowSource propiedad en uno de los UpdateRowSource valores de enumeración, puede controlar si los parámetros devueltos por el DataAdapter comando se omiten o se aplican a la fila modificada del DataSet objeto . También puede especificar si la primera fila devuelta (si existe) se aplica a la fila modificada en el DataSet objeto .
Valores de enumeración UpdateRowSource
En la tabla siguiente se describen los distintos valores de la UpdateRowSource enumeración y cómo afectan al comportamiento de un comando usado con un DataAdapter objeto .
| Nombre del miembro | Descripción |
|---|---|
| Ambos | Tanto los parámetros de salida como la primera fila de un conjunto de resultados devueltos se pueden asignar a la fila modificada de DataSet. |
| ReturnedFirstRecord | Solo los datos de la primera fila de un conjunto de resultados devueltos se pueden asignar a la fila modificada de DataSet. |
| None | Se pasan por alto todos los parámetros de salida y las filas del conjunto de resultados devuelto. |
| OutputParameters | Solo los parámetros de salida se pueden asignar a la fila modificada en DataSet. |