• Article

Spécification d'arguments de méthode de service Web

Une méthode de service Web Report Server envoie une demande au service à une URL donnée à l'aide de SOAP sur HTTP. Le service reçoit la demande, la traite, puis renvoie une réponse. Ces demandes et réponses prennent la forme de documents XML.

Paramètres facultatifs

Dans certains cas, une méthode de service Web peut comporter des paramètres d'entrée facultatifs. Quand bien même un paramètre d'entrée d'une méthode de service Web est facultatif, vous devez quand même l'inclure et lui affecter la valeur null (Nothing dans Visual Basic). L'affectation de la valeur null à un paramètre permet d'affecter la valeur null à l'élément de ce paramètre dans la demande SOAP.

L'exemple suivant utilise la méthode CreateFolder pour créer un dossier nommé Product Sales dans le dossier Sales. En spécifiant la valeur null pour les propriétés du dossier, aucune propriété propre à l'utilisateur n'est fournie pour le dossier :

// C#
rs.CreateFolder("Product Sales", "/Sales", null);

Types de données complexes

La classe principale du service Web Report Server est l'objet ReportingService2010, que vous utilisez pour appeler les opérations SOAP ou les méthodes Web de la classe proxy. Pour prendre en charge cette classe et ses méthodes, Reporting Services inclut des types de données complexes et définis par l'utilisateur qui sont propres aux paramètres d'entrée et de sortie des méthodes de service Web. Ces types de données complexes font partie de la classe proxy générée, que vous pouvez utiliser dans le cadre d'un développement dans l'environnement Microsoft .NET Framework.

Lorsque vous générez une classe proxy, les types de données complexes définis dans le fichier WSDL sont représentés par les classes du proxy, qui incluent des propriétés qui correspondent aux divers éléments SOAP des types de données complexes. Les séquences de ces types de données deviennent des tableaux d'objets que vous pouvez énumérer dans votre code. Cela élimine le besoin d'utiliser directement les structures XML envoyées dans les messages SOAP. Le .NET Framework gère cette traduction à votre place.