Editor de la colección de parámetros
Actualización: noviembre 2007
Permite crear y para configurar parámetros (objetos OleDbParameter, SqlParameter, OdbcParameter y OracleParameter) asociados a una instrucción SQL o a un procedimiento almacenado en TableAdapters y adaptadores de datos.
Editar la colección de parámetros
El Editor de la colección de parámetros se muestra cuando se utiliza la ventana Propiedades para configurar un TableAdapter en el Diseñador de DataSet o un adaptador de datos en un formulario o componente.
Seleccione un TableAdapter en la superficie del Diseñador de DataSet y seleccione la propiedad Parameters en la ventana Propiedades para abrir el Editor de la colección de parámetros.
Abra el nodo para las propiedades SelectCommand, UpdateCommand, InsertCommand y DeleteCommand.
Edite la propiedad Parameters para abrir el Editor de la colección de parámetros.
.gif "Nota") Nota: |
|---|
Si utiliza herramientas de diseño de datos como el Asistente para la configuración de TableAdapter o el Asistente para la configuración del adaptador de datos para configurar los adaptadores, los parámetros del adaptador se configuran automáticamente. |
Nomenclatura de los parámetros
Las instrucciones o procedimientos almacenados en estos comandos pueden definirse con marcadores de posición de parámetro.
Si se usa un objeto OleDbDataAdapter, las instrucciones utilizan un signo de interrogación de cierre como marcador de posición, adoptando el siguiente aspecto:
Select * From Customers Where City = ?
Si se usa un objeto SqlDataAdapter, las instrucciones que utilicen parámetros con nombre tendrán este aspecto:
Select * From Customers Where City = @City
Si se usa un objeto OracleDataAdapter, las instrucciones que utilicen parámetros con nombre de Oracle tendrán este aspecto:
SELECT * FROM Customers WHERE CustomerID = :pCustomerID
| Nota: |
|---|
Para Oracle, al utilizar los parámetros con nombre en una instrucción SQL o procedimiento almacenado, debe incluir dos puntos (:) delante del nombre del parámetro. Sin embargo, cuando haga referencia a un parámetro con nombre en otra parte del código (por ejemplo, al llamar al método Add), no coloque dos puntos (:) delante del parámetro con nombre. El proveedor de datos incluye los dos puntos automáticamente. |
Agregar parámetros
La colección Parameters de un comando (por ejemplo, Parameters) contiene una lista de objetos de parámetro que se utilizan en tiempo de ejecución para pasar valores a las instrucciones o procedimientos almacenados. Por consiguiente, existe un objeto de parámetro para cada valor que deba pasarse a un comando.
El editor se divide en dos paneles. En el panel izquierdo se agregan y se quitan parámetros, y en el derecho se establecen las propiedades de un parámetro individual, entre ellas:
La propiedad ParameterName, mediante la que se hace referencia al parámetro en el código.
Nota:La clase SqlDataAdapter requiere parámetros con nombre, por lo tanto, en los objetos SqlParameter, el nombre debe ir siempre precedido del símbolo "@".
La propiedad SourceColumn, que identifica de dónde proviene el valor del parámetro en un registro de datos. Durante las actualizaciones, el adaptador de datos pasa este valor de una columna determinada al comando de actualización.
La propiedad SourceVersion, que se utiliza junto con la propiedad SourceColumn. Si un registro de un conjunto de datos cambió, existirán varias copias disponibles, incluidos el valor original (como se leyó del origen de datos) y el valor actual (después de los cambios). Cuando se especifique un valor de columna para pasarlo como parámetro, se deberá seleccionar cuál de los dos valores se pasa. Normalmente, el valor original se utiliza como parámetro en una cláusula WHERE para identificar el registro en la base de datos, y el valor actual se usa en cláusulas SET o VALUES.
La propiedad Value, que es un valor literal explícito para pasarlo como parámetro. Si se establece esta propiedad, se reemplazará la propiedad SourceColumn, ya que ambas son mutuamente excluyentes.
Para obtener más información acerca de los parámetros, vea Parámetros de los comandos de adaptadores de datos.
Lista de elementos de la interfaz de usuario
Agregar
Crea un nuevo parámetro en la colección. De forma predeterminada, la tabla se denomina Parametern, donde n es un número secuencial. Se puede cambiar el nombre de la tabla configurando su propiedad ParameterName en la cuadrícula de propiedades.Nota:El Editor de la colección OleDbParameter no comprueba si se ha creado el número adecuado de parámetros para el comando, o si son del tipo correcto.
Los parámetros se hacen coincidir con los marcadores de posición de las instrucciones o los comandos por su posición. Por consiguiente, asegúrese de que los parámetros están ordenados correctamente en la colección.
Eliminar
Elimina el parámetro seleccionado de la colección.
Vea también
Conceptos
Información general sobre la presentación de datos
Referencia
Otros recursos
Conectarse a datos en Visual Studio
Preparar la aplicación para recibir datos
Mostrar datos en formularios en aplicaciones para Windows