Parameter
Los objetos Parameter definen los parámetros de entrada, salida y devolución de cada método. Los parámetros contienen información como:
La dirección del parámetro (In, Out, InOut, Return).
El número ordinal del parámetro en la firma del método.
Si el parámetro es opcional.
El TypeReflector. Cada objeto Parameter contiene un TypeReflector. El TypeReflector es el responsable de crear una instancia en un objeto Parameter con valores predeterminados según la estructura indicada por TypeDescriptor y de obtener o establecer los valores de configuración para los campos individuales a los que hacen referencia los descriptores de tipos en el objeto Parameter instanciado.
Un parámetro de devolución en el Catálogo de datos profesionales es el valor que se debe leer desde la aplicación back-end.
Nota
En Microsoft Office SharePoint Server 2007, el parámetro de devolución de un método debe aparecer en último lugar en la lista de parámetros del método.
Si un método web devuelve void, es probable que devuelva un valor en un parámetro de salida. Debe describir ese parámetro como parámetro de devolución en los metadatos.
Para los métodos web, los nombres de parámetros son identificadores usados por el Catálogo de datos profesionales. Aunque deben ser únicos para un método determinado, se les puede asignar el nombre que se desee. Los nombres de TypeDescriptor, sin embargo, deben coincidir exactamente con las estructuras y campos devueltos por los métodos de aplicación back-end.
En el caso de una base de datos, los nombres de los parámetros deben coincidir exactamente con los nombres de los parámetros de la consulta SQL o del procedimiento almacenado.
Nota
En Microsoft Office SharePoint Server 2007, el Catálogo de datos profesionales no es compatible con los valores devueltos desde parámetros SQL o procedimientos almacenados. Además, sólo admite consultas de base de datos o procedimientos almacenados que devuelvan un único conjunto de registros de la base de datos.
Ejemplos
Descripción
En los siguientes ejemplos se muestra un parámetro de entrada y un parámetro de devolución que representan una recopilación de instancias de entidad del cliente.
Código
Parámetro de entrada
<Parameters>
<Parameter Direction="In" Name="@minCustId">
….
….
</Parameter>
<Parameter …..>
</Parameter>
</Parameters>
Parámetro de devolución
<Parameters>
<Parameter Direction="Return" Name="Customers">
….
….
</Parameter>
</Parameters>
Esquema
| Elemento secundario | Tipo | Aparece | Predeterminada | Límites / Valores aceptados | Descripción |
|---|---|---|---|---|---|
Direction |
Atributo (bdc:ParameterDirection) |
1..1 |
In Out InOut Return |
Especifica la dirección en la que se pasa el parámetro entre el Catálogo de datos profesionales y el sistema. In: el Catálogo de datos profesionales inicializa el parámetro y lo pasa al sistema. Out: el sistema inicializa el parámetro y lo pasa al Catálogo de datos profesionales (corresponde a la palabra clave out de Visual C#). InOut: el Catálogo de datos profesionales inicializa el parámetro y lo pasa al sistema, que puede modificarlo antes de devolverlo al Catálogo de datos profesionales (corresponde a la palabra clave ref de Visual C#). Return: el sistema inicializa el parámetro y lo pasa al Catálogo de datos profesionales como el valor devuelto de un método. En Microsoft Office SharePoint Server 2007, el parámetro de devolución de un método debe aparecer en último lugar en la lista de parámetros del método. |
|
TypeReflectorTypeName |
Atributo |
Especifica el nombre completo de un ITypeReflector personalizado. |
|||
TypeDescriptor |
Elemento |
1..1 |
TypeDescriptor que describe el tipo de este parámetro. |
Vea también
Otros recursos
Ejemplo de SQL Server 2000 de AdventureWorks
Procedimiento para familiarizarse con el uso del modelo de objetos Runtime
Procedimiento para empezar a usar el modelo de objetos Administración
Preguntas más frecuentes sobre el Catálogo de datos profesionales
Catálogo de datos profesionales: glosario