Handling Exceptions in Reporting Services
When a Reporting Services SOAP API client request cannot be completed, the report server returns an error rather than the expected results of the call. When a call cannot complete, an error for the Report Server Web service is returned as a SOAP Fault XML element. The key descriptive element of the fault is the detail element, which includes all of the error information provided by the report server as well as any additional Web service error information. The key information in the detail element is the report server error code. Based on the message and error code, you can determine the next appropriate action to take in your applications. For more information about SOAP faults, see the World Wide Web Consortium (W3C) Web site at http://www.w3.org/TR/SOAP.
SOAP Faults and the .NET Framework
In the Microsoft .NET Framework, if an error occurs in a client request to the Web service, the report server communicates the error to the client code that calls the Web service by throwing a SoapException object. The SoapException wraps the information contained in a SOAP fault. The Detail property of the SoapException maps to the detail element in the SOAP fault. Applications should catch the SoapException object with a try/catch block and use the Detail property of the SoapException to take appropriate action. For more information about the SoapException class and the Detail property in Reporting Services, see Reporting Services SoapException Class. For more information about the SoapException class, see the Microsoft .NET Framework SDK documentation.
See Also