Alertes Excel Services

Services Web Excel affiche des alertes pour les erreurs qui se produisent dans le service Web et les erreurs retournées par les Excel Calculation Services.

Les erreurs s'affichent dans l'application d'un développeur de trois façons :

• Les erreurs de calcul Excel sont retournées de la même façon que dans Excel, c'est-à-dire en tant que valeurs d'erreur de cellule, telles que #VALUE!. Lorsque vous appelez la méthode GetCell ou GetRange et demandez des valeurs mises en forme, vous obtenez une chaîne d'erreur de style #. Si vous demandez des valeurs non mises en forme, vous obtenez un code d'erreur énuméré. Pour plus d'informations, voir la section « Codes d'erreur » plus loin dans cette rubrique.

• Lorsqu'une erreur se produit pendant le traitement d'une des méthodes du service Web et empêche l'exécution de la méthode, l'erreur est affichée en tant qu'exception SOAP (Simple Object Access Protocol). Vous pouvez et devez intercepter cette erreur dans votre code. Ces types d'erreurs sont aussi appelés alertes d'arrêt.

• Les erreurs qui n'empêchent pas la méthode de retourner des résultats normaux sont retournées en tant que partie intégrante des arguments de la méthode, plus particulièrement en tant qu'argument de sortie. Ces types d'erreurs sont considérés comme des erreurs non critiques. La raison pour laquelle les erreurs sont retournées en tant qu'argument de sortie plutôt qu'exception réside dans le fait que lever une exception détournerait le code de son chemin d'exécution standard, ce qui n'est pas souhaitable avec des erreurs non critiques. La vérification de la présence d'erreurs est facultative. Ces types d'erreurs sont aussi appelés alertes continues.

Types d'alertes

Il existe deux types d'alertes : alertes d'arrêt et alertes continues.

Alertes d'arrêt

Les alertes d'arrêt entraînent l'arrêt de l'opération en cours. Cela signifie que l'état du classeur antérieur à toute exécution de l'opération en cours sera restauré. Les alertes d'arrêt sont affichées en tant qu'exceptions SOAP (Simple Object Access Protocol).

Alertes continues

Les alertes continues sont généralement des avertissements ou des erreurs non critiques. Lorsque les Excel Calculation Services génèrent une alerte continue, l'opération se poursuit. Ces alertes sont retournées en tant qu'arguments de sortie, struct composé des différents champs d'alertes. Pour plus d'informations, voir les rubriques sur la référence de classe Status dans l'espace de noms Microsoft.Office.Excel.Server.WebServices.

Exceptions à intercepter

Vous devez intercepter les erreurs spécifiques aux Excel Calculation Services qui peuvent être provoquées par l'utilisateur. Par exemple, si votre application invite l'utilisateur à taper le chemin d'accès à un classeur, l'utilisateur peut taper un chemin d'accès incorrect ou sélectionner un classeur qui n'existe pas. En tant que développeur vous ne pouvez pas contrôler la saisie de l'utilisateur, mais vous pouvez contrôler l'expérience utilisateur lorsqu'un utilisateur orthographie mal le nom d'un fichier de classeur.

Vous devez intercepter les exceptions SOAP (c'est-à-dire les alertes d'arrêt) dans votre code. Pour les alertes continues, le code appelant peut choisir d'ignorer ou de vérifier les informations d'alerte.

Codes d'erreur

Pour faciliter l'interception de conditions d'erreur spécifiques, une alerte des Excel Calculation Services dispose d'un code d'erreur associé. Le service Web retourne ensuite l'erreur en utilisant les propriétés de la classe SoapException.

Pour plus d'informations, voir la rubrique « SoapException, classe » dans la documentation de Microsoft .NET Framework SDK.

Gestion des exceptions

Si votre application (client SOAP) envoie une demande à un service Web, que le service n'est pas en mesure de traiter, le service retourne une exception SOAP au client. La gestion des exceptions levées par les Services Web Excel représente un aspect important des applications que vous développez, car vous pouvez retourner des informations spécifiques aux utilisateurs lorsque des erreurs se produisent. La gestion des exceptions permet aussi d'améliorer l'expérience utilisateur lorsqu'un événement inattendu se produit dans votre application.

Pour obtenir des informations d'ordre général sur la gestion des exceptions, voir « Gestion et levée d'exceptions » dans la documentation de Microsoft .NET Framework SDK.

Voir aussi

Autres ressources

Étape 3: accès au service Web
Étape 4 : création et test de l'application
Procédure pas à pas : développement d'une application personnalisée à l'aide des services Web Excel
Accès à l'API SOAP
Codes d'erreurs Excel Services
Procédure : approuver les emplacements des classeurs à l'aide de scripts