Edit

Reporting Services SoapException class

  • Article

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 don't 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 Description
Actor The code that caused the exception. The value is the URL to the Web service method.
Detail Application-specific error information. The report server sets the value and is in XML format. For more information, see Detail property and Use the Detail property to handle specific errors.
HelpLink A URL or URN to a Help file associated with the error. The Web Service usually sets the value 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.
Message A descriptive, localized message that describes the error. This text might appear in the application UI.

Related content

Introduction to exception management in Reporting Services
SoapException Errors table