Objeto ParameterParameter Object

Representa un parámetro o un argumento asociado a un objeto de comando basado en una consulta con parámetros o un procedimiento almacenado.Represents a parameter or argument associated with a Command object based on a parameterized query or stored procedure.

ObservacionesRemarks

Muchos proveedores admiten comandos con parámetros.Many providers support parameterized commands. Se trata de comandos en los que se define la acción deseada una vez, pero se usan variables (o parámetros) para modificar algunos detalles del comando.These are commands in which the desired action is defined once, but variables (or parameters) are used to alter some details of the command. Por ejemplo, una instrucción SELECT de SQL podría usar un parámetro para definir los criterios de coincidencia de una cláusula WHERE y otro para definir el nombre de columna para una cláusula SORT BY.For example, an SQL SELECT statement could use a parameter to define the matching criteria of a WHERE clause, and another to define the column name for a SORT BY clause.

Los objetos de parámetro representan los parámetros asociados a las consultas con parámetros o los argumentos in/out y los valores devueltos de los procedimientos almacenados.Parameter objects represent parameters associated with parameterized queries, or the in/out arguments and the return values of stored procedures. Dependiendo de la funcionalidad del proveedor, es posible que algunas colecciones, métodos o propiedades de un objeto de parámetro no estén disponibles.Depending on the functionality of the provider, some collections, methods, or properties of a Parameter object may not be available.

Con las colecciones, los métodos y las propiedades de un objeto de parámetro , puede hacer lo siguiente:With the collections, methods, and properties of a Parameter object, you can do the following:

  • Establece o devuelve el nombre de un parámetro con la propiedad Name .Set or return the name of a parameter with the Name property.

  • Establece o devuelve el valor de un parámetro con la propiedad Value .Set or return the value of a parameter with the Value property. Value es la propiedad predeterminada del objeto Parameter .Value is the default property of the Parameter object.

  • Establezca o devuelva características de parámetro con las propiedades attributes, Direction, Precision, NumericScale, sizey Type .Set or return parameter characteristics with the Attributes, Direction, Precision, NumericScale, Size, and Type properties.

  • Pase datos binarios o de caracteres largos a un parámetro con el método AppendChunk .Pass long binary or character data to a parameter with the AppendChunk method.

  • Obtener acceso a los atributos específicos del proveedor mediante la colección Properties .Access provider-specific attributes by using the Properties collection.

Si conoce los nombres y las propiedades de los parámetros asociados al procedimiento almacenado o a la consulta parametrizada a la que desea llamar, puede usar el método CreateParameter para crear objetos de parámetro con la configuración de propiedades adecuada y usar el método Append para agregarlos a la colección de parámetros .If you know the names and properties of the parameters associated with the stored procedure or parameterized query you want to call, you can use the CreateParameter method to create Parameter objects with the appropriate property settings and use the Append method to add them to the Parameters collection. Esto le permite establecer y devolver valores de parámetro sin tener que llamar al método Refresh en la colección Parameters para recuperar la información de parámetros del proveedor, una operación que consume muchos recursos.This lets you set and return parameter values without having to call the Refresh method on the Parameters collection to retrieve the parameter information from the provider, a potentially resource-intensive operation.

El objeto de parámetro no es seguro para el scripting.The Parameter object is not safe for scripting.

Esta sección contiene el siguiente tema.This section contains the following topic.

Consulte tambiénSee Also

Command (objeto) (ADO) Command Object (ADO)
CreateParameter (método) (ADO) CreateParameter Method (ADO)
Parameters (colección) (ADO) Parameters Collection (ADO)
Colección de propiedades (ADO)Properties Collection (ADO)