Excel Services-Benachrichtigungen

Artikel
03/21/2023

Excel Web Services exposes alerts for errors that occur within the Web service and errors that are returned by Dienste für Excel-Berechnungen.

Errors are exposed in the following ways:

Excel calculation errors are returned similarly to how they are shown in Excelthat is, as cell error values, such as #VALUE!. When you call the GetCell or GetRange methods and request formatted values, you will get the # style error string. If you request unformatted values, you will get an enumerated error code. For more information, see the Error Codes section later in this topic.
When an error occurs during the processing of one of the Web service methods, preventing the method from finishing successfully, the error is exposed as a Simple Object Access Protocol (SOAP) exception. You can and should catch this error in your code. These types of errors are also known as "stop" alerts.
Errors that do not prevent the method from returning normal results are returned as part of the method arguments, specifically as an output argument. Diese Fehlertypen werden als nicht kritische Fehler betrachtet. Der Grund, warum die Fehler als Ausgabeargument anstelle einer Ausnahme zurückgegeben werden, liegt darin, dass das Auslösen einer Ausnahme den Code vom normalen Ausführungspfad ablenken würde, was bei nicht kritischen Fehlern nicht wünschenswert ist. Die Überprüfung auf diese Fehler ist optional. Diese Fehlertypen werden auch als "Weiter"-Warnungen bezeichnet.

Types of Alerts

There are two types of alerts: "stop" and "continue."

"stop" alerts

Die Warnung "Stop" bewirkt, dass der aktuelle Vorgang beendet wird. Dies bedeutet, dass die Arbeitsmappe vor der Ausführung des aktuellen Vorgangs auf ihren Zustand zurückgesetzt wird. Die "Stop"-Warnungen werden als SOAP-Ausnahmen verfügbar gemacht.

"continue" alerts

Die "Continue"-Warnung ist in der Regel eine Warnung oder ein nicht kritischer Fehler. Wenn Excel-Berechnungsdienste eine "Continue"-Warnung auslösen, wird der Vorgang fortgesetzt. Diese Warnungen werden als out-Argumente zurückgegeben– eine Struktur mit den verschiedenen Warnungsfeldern. Weitere Informationen finden Sie in den Referenzthemen zur Status-Klasse im Microsoft.Office.Excel.Server.WebServices-Namespace .

Exceptions to Catch

Sie sollten spezifische Fehler für Dienste für Excel-Berechnungen abfangen, von denen Sie wissen, dass der Benutzer dies verursachen kann. Wenn Ihre Anwendung den Benutzer beispielsweise auffordert, den Pfad zu einer Arbeitsmappe einzugeben, kann der Benutzer den falschen Pfad eingeben oder eine Arbeitsmappe auswählen, die nicht vorhanden ist. Sie können nicht steuern, was der Benutzer eingibt, aber Sie können die Benutzererfahrung steuern, wenn ein Benutzer unbeabsichtigt einen Arbeitsmappendateinamen falsch schreibt.

Sie sollten die SOAP-Ausnahmen (d. h. "Stoppwarnungen") in Ihrem Code abfangen. Bei "Continue"-Warnungen kann der aufrufende Code die Warnungsinformationen ignorieren oder überprüfen.

Fehlercodes

Um das Abfangen bestimmter Fehlerbedingungen zu ermöglichen, verfügt eine Excel-Berechnungsdienste-Warnung über einen zugeordneten Fehlercode. Der Webdienst gibt dann den Fehler mithilfe von Eigenschaften der SoapException-Klasse zurück.

For more information, see the "SoapException Class" topic in the Microsoft .NET Framework SDK documentation.

Exception Handling

Wenn Ihre Anwendung (d. h. Ihr SOAP-Client) eine Anforderung an einen Webdienst sendet, die der Dienst nicht verarbeiten kann, gibt der Dienst eine SOAP-Ausnahme an den Client zurück. Die Behandlung von Ausnahmen, die von Excel Web Services ausgelöst werden, ist ein wichtiger Bestandteil der Anwendungen, die Sie entwickeln, da Sie bestimmte Informationen an Benutzer zurückgeben können, wenn Fehler auftreten. Die Ausnahmebehandlung kann auch dazu beitragen, die Benutzererfahrung zu verbessern, wenn in Ihrer Anwendung unerwartete Vorgänge auftreten.

For general information about exception handling, see "Handling and Throwing Exceptions" in the Microsoft .NET Framework SDK documentation.