| title | Supplying Web Service Method Arguments | ||||
|---|---|---|---|---|---|
| description | Learn about arguments for Web Service methods in Reporting Services, including optional parameters and complex data types. | ||||
| ms.date | 09/25/2024 | ||||
| ms.service | reporting-services | ||||
| ms.subservice | report-server-web-service | ||||
| ms.topic | reference | ||||
| ms.custom |
|
||||
| helpviewer_keywords |
|
A Report Server Web service method sends a request to the service at a given URL using SOAP over HTTP. The service receives the request, processes it, and then returns a response. These requests and responses are in the form of XML documents.
In some cases, a Web service method can have optional input parameters. Even if an input parameter for a Web service method is optional, you must still include it and set the parameter value to null (Nothing in [!INCLUDEvisual-basic]). Setting a parameter value to null sets the element value for that parameter in the SOAP request to null.
The following example uses the xref:ReportService2010.ReportingService2010.CreateFolder%2A method to create a new folder named Product Sales in the Sales folder. By supplying a null value for the folder properties, no user-specific properties are supplied for the folder:
// C#
rs.CreateFolder("Product Sales", "/Sales", null);
The core class of the Report Server Web service is xref:ReportService2010.ReportingService2010, which you use to invoke the SOAP operations or Web methods of the proxy class. To support this class and its methods, [!INCLUDEssRSnoversion] includes user-defined, complex data types that are specific to the input and output parameters of the Web service methods. These complex data types are part of the generated proxy class, which you can use when developing in the [!INCLUDEmsCoName] [!INCLUDEdnprdnshort] environment.
When you generate a proxy class, the complex data types that are defined in the WSDL file are represented by the classes of the proxy, which include properties that correspond to the various SOAP elements of the complex data types. Sequences of these data types become arrays of objects that you can enumerate through in your code. This eliminates the need to work directly with the XML structures sent in SOAP messages. The [!INCLUDEdnprdnshort] handles that translation for you.