Reporting Services SoapException Class

You should address specific Reporting Services errors that you know might happen. For example, in an application where you ask the user to create a folder, it might be possible for the user to try to create a folder that already exists. As the developer, you do not have control over what the user enters in the folder name and path fields of your application, but you do have control over what the user experience is when someone incidentally tries to create an item that already exists.

To make it easier for you to catch specific error conditions, Reporting Services classifies an error code for the exception and returns the classification of the error using properties from the SoapException class. For more information, see "SoapException Class" in the Microsoft .NET Framework SDK documentation.

The following table lists the public properties of the SoapException class.

Public property



The code that caused the exception. The value is the URL to the Web service method.


Application-specific error information. The value is set by the report server and is in XML format. For more information, see Detail Property and Using the Detail Property to Handle Specific Errors.


A URL or URN to a Help file associated with the error. The value is usually set by the Web service and it sets a URL to Microsoft Help and Support. Because Reporting Services supports multiple help links for errors that occur, the report server sets help link information as part of the Detail property. For more information, see HelpLink Element.


A descriptive, localized message that describes the error. This text might appear in the application UI.