Editor de la colección de parámetros (Cuadro de diálogo)

Actualización: noviembre 2007

Permite crear y configurar parámetros para consultas SQL, métodos de objetos comerciales o expresiones de filtrado asociadas a los controles de origen de datos ObjectDataSource, SqlDataSource y AccessDataSource. Los objetos Parameter se evalúan en tiempo de ejecución para enlazar los valores de las variables que representan con los métodos utilizados por los controles de origen de datos para interactuar con los datos. Los objetos Parameter están contenidos en un objeto ParameterCollection.

Tareas

Editar la colección de parámetros

El cuadro de diálogo Editor de la colección de parámetros se muestra cuando se está utilizando la ventana Propiedades para configurar un control ObjectDataSource, SqlDataSource o AccessDataSource en la vista Diseño.

Seleccione el control SqlDataSource o AccessDataSource en la superficie de diseño y, a continuación, seleccione la propiedad FilterParameters en la ventana Propiedades para abrir el cuadro de diálogo Editor de la colección de parámetros. En el control ObjectDataSource, seleccione las propiedades DeleteParameters, FilterParameters, SelectParameters y UpdateParameters en la ventana Propiedades para abrir el cuadro de diálogo Editor de la colección de parámetros.

Nomenclatura de los parámetros

Las instrucciones o procedimientos almacenados del cuadro de diálogo Editor de la colección de parámetros se pueden definir con marcadores de posición de parámetro. Como productos de base de datos diferentes utilizan variedades diferentes de SQL, la sintaxis de la cadena de SQL depende del proveedor de ADO.NET actual que se está utilizando, identificado por la propiedad ProviderName. Si la cadena de SQL es un comando o consulta parametrizado, el marcador de posición del parámetro también depende del proveedor de ADO.NET que se está utilizando. Por ejemplo, si el proveedor es el espacio de nombres System.Data.SqlClient, que es el proveedor predeterminado para la clase SqlDataSource, el marcador de posición del parámetro es @parameterName. Sin embargo, si el proveedor se establece en el espacio de nombres System.Data.Odbc o System.Data.OleDb, el marcador de posición del parámetro es ?. Para obtener más información sobre comandos y consultas SQL parametrizados, vea Utilizar parámetros con el control SqlDataSource.

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 parámetros individuales, entre ellas:

Elementos de interfaz de usuario

  • Parámetros
    Muestra los parámetros que se encuentran actualmente en la colección de parámetros.

  • Agregar parámetro
    Crea un nuevo parámetro en la colección. De manera predeterminada, el parámetro se denomina newparameter. Seleccione el nombre del parámetro para cambiarlo.

    Para reorganizar los parámetros, haga clic en los botones apropiados, como se indica en la tabla siguiente.

    Para

    Haga clic en este botón

    Mover un parámetro hacia arriba en la jerarquía

    Mover un parámetro hacia abajo en la jerarquía

    Eliminar un parámetro de la jerarquía

  • Origen del parámetro
    Especifica el origen de datos del parámetro. Cada origen da como resultado un control Parameter diferente en ParameterCollection. Las opciones son las que se muestran en la tabla siguiente

    Origen

    Parámetro resultante

    None

    Parameter

    Control

    ControlParameter

    Cookie

    CookieParameter

    Form

    FormParameter

    Field

    ProfileParameter

    QueryString

    QueryStringParameter

    Session

    SessionParameter

  • Mostrar propiedades avanzadas
    Muestra las propiedades avanzadas del parámetro actualmente seleccionado.

  • Propiedades
    Muestra las propiedades del control Parameter.

  • Ocultar propiedades avanzadas
    Oculta las propiedades avanzadas del parámetro actualmente seleccionado.

Vea también

Conceptos

Utilizar parámetros con el control SqlDataSource

Referencia

Parameter