Propiedad Form. InputParameters (Access)Form.InputParameters property (Access)

Puede usar la propiedad ParámetrosEntrada (InputParameters ) para especificar o determinar los parámetros de entrada que se pasan a una instrucción SQL en la propiedad OrigenDelRegistro de un formulario o informe, o un procedimiento almacenado cuando se utiliza como el origen de registros en un formulario de Microsoft Access. proyecto (. ADP).You can use the InputParameters property to specify or determine the input parameters that are passed to a SQL statement in the RecordSource property of a form or report, or a stored procedure when used as the record source within a Microsoft Access project (.adp). String de lectura y escritura.Read/write String.

SintaxisSyntax

expresión. InputParametersexpression.InputParameters

expresión Variable que representa un objeto Form.expression A variable that represents a Form object.

ObservacionesRemarks

Cuando se usa con una propiedad RecordSourceWhen used with a RecordSource property

Como ejemplo de una cadena de la propiedad InputParameters usada con una instrucción SQL en la propiedad RecordSource se podría usar la siguiente sintaxis.An example InputParameters property string used with a SQL statement in the RecordSource property would use the following syntax.

state char=[Forms]![formname]![StateList], salesyear smallint=[Forms]![formname]![Enter year of interest]

Esto daría como resultado que el parámetro State se establezca en el valor actual del control ListaDeEstados y que se solicite al usuario el parámetro añoventas .This would result in the state parameter being set to the current value of the StateList control, and the user getting prompted for the salesyear parameter. Si hay otros parámetros que no estén en esta lista, se les asignarán valores predeterminados.If there were any other parameters that were not in this list, they would get default values assigned.

La consulta debe ejecutarse con un marcador para cada parámetro no predeterminado de la lista de InputParameters .The query should be executed with one marker for each non-default parameter in the InputParameters list.

Un comando de actualización o de nueva consulta (a través del menú, el teclado o la barra de navegación) en Access debe desencadenar una nueva ejecución de la consulta.A refresh or requery command (via menu, keyboard, or navigation bar) in Access should trigger a reexecute of the query. Los usuarios pueden hacer esto en el código llamando al **** método Requery estándar.Users can do this in code by calling the standard Requery method. Si el valor de un parámetro depende de un control del formulario, se usa el valor actual del control en el momento de ejecutar la nueva consulta.If the value of a parameter is bound to a control on the form, the current value of the control is used at requery time. La consulta no se vuelve a ejecutar automáticamente cuando cambia el valor del control.The query is not automatically reexecuted when the value of the control changes.

Cuando se usa con un procedimiento almacenadoWhen used with a stored procedure

Un ejemplo de cadena de la propiedad InputParameters usada con un procedimiento almacenado usaría la siguiente sintaxis.An example InputParameters property string used with a stored procedure would use the following syntax.

@state char=[Forms]![formname]![StateList], @salesyear smallint=[Forms]![formname]![Enter year of interest]

Como resultado, el parámetro @state se establecerá en el valor actual del control ListaDeEstados y se solicitará al usuario el parámetro @salesyear.This would result in the @state parameter being set to the current value of the StateList control, and the user getting prompted for the @salesyear parameter. Si hubiera otros parámetros para el procedimiento almacenado que no estuvieran en esta lista, obtendría los valores predeterminados asignados.If there were any other parameters to the stored procedure that were not in this list, they would get default values assigned.

El procedimiento almacenado debe ejecutarse mediante una cadena de comandos que contenga la sintaxis {Call} con un marcador para cada parámetro no predeterminado de la lista de InputParameters .The stored procedure should be executed by using a command string containing the {call } syntax with one marker for each non-default parameter in the InputParameters list.

Un comando de actualización o de nueva consulta (a través del menú, el teclado o la barra de navegación) en Access debe desencadenar una nueva ejecución del procedimiento almacenado.A refresh or requery command (via menu, keyboard, or navigation bar) in Access should trigger a reexecute of the stored procedure. Los usuarios pueden hacer esto en el código llamando al **** método Requery estándar.Users can do this in code by calling the standard Requery method. Si el valor de un parámetro depende de un control del formulario, se usa el valor actual del control en el momento de ejecutar la nueva consulta.If the value of a parameter is bound to a control on the form, the current value of the control is used at requery time. El procedimiento almacenado no se vuelve a ejecutar automáticamente cuando cambia el valor del control.The stored procedure is not automatically reexecuted when the value of the control changes.

Este cuadro de diálogo del generador se abre cuando se selecciona primero un procedimiento almacenado como el origen de registros de un formulario si el procedimiento almacenado tiene algún parámetro.This builder dialog is invoked when a stored procedure is first selected as the record source of a form if the stored procedure has any parameters. Tras la creación inicial de la cadena InputParameters, se utiliza este mismo cuadro de diálogo como un generador para cambiar la cadena.After initial creation of the InputParameters string, this same dialog is used as a builder for changing the string. Sin embargo, en este caso, la lista de parámetros procede de lo que ya existe en la cadena.In this case, however, the list of parameters comes from what already exists in the string.

Los valores de parámetro también se pueden establecer en el código mediante el uso de los objetos Command y Parameter del objeto de datos ActiveX (ADO).Parameter values are also settable in code by using the ActiveX Data Object's (ADO) Command and Parameter objects. Si el resultado devuelve un conjunto de resultados, se le puede enlazar un formulario estableciendo la propiedad Recordset del formulario.If the result returns a result set, a form can be bound to it by setting the form's Recordset property. La codificación ADO es la única manera de tratar procedimientos almacenados que no devuelven conjuntos de resultados como las consultas de acción, los que devuelven parámetros de salida o los que devuelven varios conjuntos de resultados.ADO coding is the only way to handle stored procedures that do not return result sets such as action queries, those that return output parameters, or those that return multiple result sets.

Soporte técnico y comentariosSupport and feedback

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación?Have questions or feedback about Office VBA or this documentation? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.