Cómo: Configurar parámetros para adaptadores de datos
Actualización: noviembre 2007
En la mayoría de las circunstancias, los objetos Command de un adaptador de datos (SelectCommand, InsertCommand, UpdateCommand y DeleteCommand) hacen referencia a instrucciones SQL o procedimientos almacenados que requieren parámetros. Si utilizó el Asistente para la configuración del adaptador de datos para crear el adaptador, los parámetros de estos comandos se configurarán automáticamente. No obstante, quizá desee configurar parámetros de forma manual o hacer pequeños cambios en una colección de parámetros existente.
.gif "Nota") Nota: |
|---|
En la versión anterior de Visual Studio, los adaptadores de datos se usaban para las comunicaciones entre una aplicación y una base de datos. Mientras que los adaptadores de datos aún son un componente principal de .Proveedores de datos de .NET Framework (ADO.NET), los objetos TableAdapters son componentes generados por diseñador que simplifican el proceso de mover datos entre la aplicación y la base de datos. Para obtener más información sobre el trabajo con objetos TableAdapters, vea Información general sobre TableAdapter. |
| Sugerencia: |
|---|
Para configurar parámetros después de hacer modificaciones a la instrucción SQL para un comando, es posible elegir la opción Volver a generar colección de parámetros para este comando en el Generador de consultas. |
| Nota: |
|---|
Los cuadros de diálogo y comandos de menú que se ven pueden diferir de los descritos en la Ayuda, en función de los valores de configuración o de edición activos. Para cambiar la configuración, elija la opción Importar y exportar configuraciones del menú Herramientas. Para obtener más información, vea Valores de configuración de Visual Studio. |
Para configurar parámetros para un adaptador de datos
Cree un adaptador de datos. Para obtener información detallada, vea Crear adaptadores de datos.
En el formulario o diseñador de componentes, seleccione el adaptador de datos y abra la ventana Propiedades.
Expanda el objeto de comando para el cual desea configurar parámetros (por ejemplo, UpdateCommand) y, a continuación, en la propiedad Parámetros, haga clic en el botón de puntos suspensivos (...) para abrir la ventana Editor de la colección de parámetros.
Para crear un nuevo objeto de parámetro, haga clic en Agregar.
Coloque el nuevo parámetro en la ubicación de índice correcta de la colección para ese parámetro haciendo clic en las flechas que se encuentran bajo Ordenar para moverlo.
Para establecer las propiedades del parámetro, selecciónelo en la lista Miembros y, a continuación, utilice la cuadrícula de propiedades que se encuentra a la derecha. La tabla siguiente enumera las propiedades que se establecen habitualmente.
Propiedad
Descripción
SourceColumn
Nombre de una columna de una tabla del conjunto de datos de la que se leerá el valor del parámetro. Esta propiedad se utiliza con parámetros que completan valores en una instrucción UPDATE, INSERT o DELETE (o en procedimientos almacenados equivalentes).
SourceVersion
Si el valor del parámetro se deriva a través de la propiedad SourceColumn, SourceVersion especifica qué versión de un registro del conjunto de datos debe utilizarse como origen del valor del parámetro:
Original: valor de la columna tal y como se leyó en la base de datos. Utilice esta opción cuando necesite saber el valor de una columna antes de que se modificase. Por ejemplo, cuando una clave principal está cambiando pero se necesita la clave anterior para buscar el registro en la base de datos.
Current: valor de la columna después de actualizar un registro. Normalmente, se trata del valor que se va a escribir en la base de datos.
Default: valor en el que se establece una columna si no se proporciona ningún valor de forma explícita.
Valor
Valor explícito que se establecerá para el parámetro. Esta propiedad suele establecerse en tiempo de ejecución, en lugar de hacerlo estáticamente en tiempo de diseño.
La propiedad Value tiene precedencia sobre la propiedad SourceColumn, si se establecen ambas.
NamedParameter
Un valor Boolean que indica si el parámetro corresponde a una variable (normalmente con el formato @nombreparámetro) o a un marcador de posición (normalmente un signo de interrogación de cierre). Si está trabajando con un objeto SqlConnection y está utilizando parámetros con nombre, establézcala en true.
DBType, Precision, Scale, Size
Información acerca del tipo de datos nativo (en el almacén de datos) del valor del parámetro. El valor del parámetro se convierte al tipo o desde el tipo que se especifique.
Dirección
Especifica si el valor del parámetro se pasa al comando o desde el comando:
Input: el valor se pasa al comando. Éste es el valor predeterminado.
Output: el valor se devuelve desde un procedimiento almacenado. (No aplicable a las instrucciones SQL.)
InputOutput: el valor se pasa a un procedimiento almacenado y se devuelve, normalmente con un valor modificado.
ReturnValue: el valor es un valor devuelto explícito. De forma predeterminada, el valor devuelto es el primer elemento (valor cero del índice) de la colección de parámetros.
ParameterName
Nombre por el que se puede hacer referencia a un parámetro de la colección, en lugar de hacerlo por su valor de índice. Aunque no es necesario, se recomienda un nombre de parámetro por razones de facilidad de mantenimiento.
Haga clic en Aceptar para cerrar la ventana Editor de la colección de parámetros.
Repita los pasos 3 a 7 para configurar parámetros para otros objetos de comando.