Reporting Services SoapException 類別

您應該處理可能會發生的特定 Reporting Services 錯誤。例如,在您詢問使用者是否建立資料夾的應用程式中,使用者或許會嘗試建立已經存在的資料夾。身為開發人員,您無法控制使用者在應用程式的資料夾名稱與路徑欄位中輸入的內容,但是,您卻可以控制使用者在試圖建立已經存在的項目時所得到的體驗。

為了使您更易於捕捉特定的錯誤狀況,Reporting Services 會對例外狀況的錯誤碼進行分類,並使用 SoapException 類別的屬性傳回錯誤的分類。如需詳細資訊,請參閱 Microsoft .NET Framework SDK 文件集中的<SoapException 類別>。

下表列出 SoapException 類別的公用屬性。

公用屬性

說明

Actor

造成例外狀況的程式碼,這個值是 Web 服務方法的 URL。

Detail

應用程式特定的錯誤資訊,這個值是由報表伺服器所設定,且格式為 XML。如需詳細資訊,請參閱<詳細資料屬性>和<使用詳細資料屬性來處理特定的錯誤>。

HelpLink

與該錯誤相關聯的說明檔之 URL 或 URN。這個值通常是由 Web 服務所設定,而且它會將 URL 設定為 Microsoft 說明與支援。因為 Reporting Services 對於所發生的錯誤支援多個說明連結,所以報表伺服器會將說明連結資訊設定為 Detail 屬性的一部分。如需詳細資訊,請參閱<HelpLink 元素>。

Message

描述錯誤的當地語系化描述性訊息。此文字可能會出現在應用程式 UI 中。