提供 Web 服务方法参数

  • 项目

报表服务器 Web 服务方法通过 HTTP 上的 SOAP 向位于指定 URL 处的服务发送请求。 此服务接收请求，对其进行处理，然后返回响应。 这些请求和响应采用 XML 文档形式。

可选参数

在某些情况下，Web 服务方法可能具有可选输入参数。 即使 Web 服务方法的某个输入参数为可选，也仍必须包含该参数并将参数值设置为 null（在 Visual Basic 中为“Nothing”）。 将参数值设置为 null 后，可将 SOAP 请求中该参数的元素值设置为 null。

以下示例使用 CreateFolder 方法在 Sales 文件夹中创建名为 Product Sales 的新文件夹。 通过为文件夹属性提供 null 值，将不会为该文件夹提供用户特定的属性：

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

复杂数据类型

报表服务器 Web 服务的核心类为 ReportingService2010，您可以使用它调用 SOAP 操作或代理类的 Web 方法。 为了支持该类及其方法，Reporting Services 包含用户定义的、特定于 Web 服务方法的输入和输出参数的复杂数据类型。 这些复杂数据类型是生成的代理类的一部分，当你在 Microsoft .NET Framework 环境中进行开发时可以使用它们。

当您生成代理类时，在 WSDL 文件中定义的复杂数据类型将由该代理的各个类表示，这些类包含与复杂数据类型的各种 SOAP 元素相对应的属性。 这些数据类型的序列成为由您在代码中可以枚举的对象组成的数组。 这样，就不再需要直接使用在 SOAP 消息中发送的 XML 结构。 .NET Framework 将为你处理该转换。

另请参阅

使用 Web 服务和 .NET Framework 生成应用程序
报表服务器 Web 服务
技术参考 (SSRS)