Reporting Services SoapException-Klasse
Sie sollten bestimmte Reporting Services-Fehler angeben, die erfahrungsgemäß auftreten können. In einer Anwendung, in der Sie den Benutzer auffordern, einen Ordner zu erstellen, kann es beispielsweise passieren, dass der Benutzer einen Ordner erstellen möchte, der bereits vorhanden ist. Als Entwickler haben Sie keine Kontrolle darüber, was der Benutzer in die Ordnernamen- und Pfadfelder Ihrer Anwendung eingibt. Sie haben jedoch die Kontrolle darüber, was die Benutzererfahrung ist, wenn jemand zufällig versucht, ein bereits vorhandenes Element zu erstellen.
Um bestimmte Fehlerbedingungen leichter zu erfassen, klassifiziert Reporting Services einen Fehlercode für die Ausnahme und gibt die Fehlerklassifizierung mithilfe der Eigenschaften aus der SoapException-Klasse zurück. Weitere Informationen finden Sie unter „SoapException-Klasse“ in der Dokumentation zum Microsoft .NET Framework SDK.
In der folgenden Tabelle sind die öffentlichen Eigenschaften der SoapException-Klasse aufgeführt.
| Öffentliche Eigenschaft | BESCHREIBUNG |
|---|---|
| Actor (Schauspieler) | Der Code, der die Ausnahme verursacht hat. Der Wert ist die URL der Webdienstmethode. |
| Detail | Anwendungsspezifische Fehlerinformationen. Der Berichtsserver legt den Wert fest und weist das XML-Format auf. Weitere Informationen finden Sie unter "Detail"-Eigenschaft und "Verwenden der Detail"-Eigenschaft zum Behandeln bestimmter Fehler. |
| HelpLink | Eine URL oder eine URN zu einer zum Fehler gehörigen Hilfedatei. Der Webdienst legt in der Regel den Wert fest und legt eine URL zu Microsoft-Hilfe und -Support fest. Da Reporting Services mehrere HelpLinks für auftretende Fehler unterstützt, richtet der Berichtsserver die HelpLink-Informationen als Teil der Detail-Eigenschaft ein. Weitere Informationen finden Sie unter HelpLink-Element. |
| Meldung | Eine informative, lokalisierte Meldung, die den Fehler beschreibt. Dieser Text kann in der Benutzeroberfläche der Anwendung angezeigt werden. |