Paramètre
Les objets Parameter définissent les paramètres d'entrée, de sortie et de retour de chaque méthode. Les paramètres contiennent des informations telles que les suivantes :
Le sens du paramètre (In, Out, InOut, Return).
Le nombre ordinal du paramètre dans la signature de la méthode.
Si le paramètre est facultatif.
L'élément TypeReflector. Chaque objet Parameter contient un élément TypeReflector. L'élément TypeReflector est responsable de l'instanciation d'un objet Parameter auquel sont affectées des valeurs par défaut en fonction de la structure indiquée par l'élément TypeDescriptor, et est responsable de l'obtention ou de la définition des valeurs pour les champs individuels référencés par les descripteurs de type dans l'objet Parameter instancié.
Un paramètre de retour dans le catalogue de données métiers est la valeur qui est lue dans l'application frontale.
Notes
Dans Microsoft Office SharePoint Server 2007, le paramètre de retour d'une méthode est le dernier paramètre répertorié dans la liste des paramètres de la méthode.
Dans le cas où une méthode Web retourne void, il est probable que ce sera une valeur d'entrée dans un paramètre de sortie. Vous devez décrire ce paramètre en tant que paramètre de retour dans les métadonnées.
Pour les méthodes Web, les noms des paramètres sont des jetons utilisés par le catalogue de données métiers. S'ils doivent être uniques pour une méthode donnée, vous pouvez néanmoins les appeler comme vous voulez. Les noms des éléments TypeDescriptor doivent cependant correspondre exactement aux structures et aux champs renvoyés par les méthodes de l'application frontale.
Dans le cas d'une base de données, les noms des paramètres doivent correspondre exactement aux noms des paramètres de la procédure stockée ou de la requête SQL.
Notes
Dans Microsoft Office SharePoint Server 2007, le catalogue de données métiers ne prend pas en charge les valeurs de retour des paramètres SQL ou des procédures stockées. Par ailleurs, il ne prend en charge que les requêtes de base de données ou les procédures stockées qui renvoient un ensemble d'enregistrements unique de la base de données.
Exemples
Les exemples suivants montrent un paramètre d'entrée et un paramètre de sortie qui représentent une collection d'instances d'entité de client.
Paramètre d'entrée
<Parameters>
<Parameter Direction="In" Name="@minCustId">
….
….
</Parameter>
<Parameter …..>
</Parameter>
</Parameters>
Paramètre de retour
<Parameters>
<Parameter Direction="Return" Name="Customers">
….
….
</Parameter>
</Parameters>
Schéma
| Enfant | Type | Occurrence | Par défaut | Limites / Valeurs acceptées | Description |
|---|---|---|---|---|---|
Direction |
Attribut (bdc:ParameterDirection) |
1..1 |
In Out InOut Return |
Spécifie le sens dans lequel le paramètre est passé entre le catalogue de données métiers et le système. In : le catalogue de données métiers initialise le paramètre et le passe au système Out : le système initialise le paramètre et le passe au catalogue de données métiers (correspond au mot clé Visual C# out). InOut : le catalogue de données métiers initialise le paramètre et le passe au système, qui peut le modifier avant de le renvoyer au catalogue de données métiers. (correspond au mot clé Visual C# ref). Return : le système initialise le paramètre et le passe au catalogue de données métiers en tant que valeur de retour d'une méthode. Dans Microsoft Office SharePoint Server 2007, le paramètre de retour d'une méthode doit être le dernier paramètre répertorié dans la liste des paramètres de la méthode. |
|
TypeReflectorTypeName |
Attribut |
Spécifie le nom complet d'un élément ITypeReflector personnalisé. |
|||
TypeDescriptor |
Élément |
1..1 |
Élément TypeDescriptor décrivant le type de ce paramètre. |
Voir aussi
Autres ressources
Exemple SQL Server 2000 AdventureWorks
Procédure : utiliser le modèle objet Runtime
Procédure : mise en route de l'utilisation du modèle objet Administration
Forum aux questions : catalogue de données métiers
Catalogue de données métiers : glossaire