Alertas de Serviços Excel

Serviços Web do Excel expõe os alertas de erros que ocorrer dentro de serviço da Web e erros que são retornados por Serviços de cálculo do Excel.

Os erros estão expostos a aplicativo de um desenvolvedor de três maneiras:

• Cálculo Excel erros são retornados da mesma forma para como eles são mostrados na Excel ? isto é, como valores erro de célula, tais como valor de erro # VALOR!. Quando você chamar o GetCell ou métodos GetRange GetRange e solicitar formatado valores, você vai get a seqüência de caracteres de erro # STYLE. Se você pedir não formatado valores, você vai get um código de erro enumerados. Para obter mais informações, consulte a seção "Error Codes" neste tópico.

• Quando ocorre um erro durante o processamento de um dos métodos de serviço da Web, impedindo que o método concluir com êxito, o erro é exposto como uma exceção protocolo SOAP (SOAP). Você pode e deve capturar este erro na sua codificar. Esses tipos de erros são também conhecidas como "parar" alertas.

• Erros que não evitar o método de retornar resultados normais são retornados como parte dos argumentos método, especificamente como um argumento saída. Esses tipos de erros são considerados erros não críticos. O motivo pelo qual que os erros são retornados como um argumento saída instead of uma exceção é porque lançar uma exceção seria desviar na codificar do seu caminho de execução normal, que não é desejável com erros não críticos. A verificação para esses erros é opcional. Esses tipos de erros são também conhecidas como "Continuar" alertas.

Tipos de alertas

Existem dois tipos de alertas: "parar" e "Continuar".

Alertas "parar"

"parar" alertas causar a atual operação para parar. Isso significa que o pasta de trabalho será ser rolado voltar ao seu estado prior to qualquer local colocando a execução para o atual operação. Os alertas "parar" são expostos como exceções protocolo SOAP (SOAP).

"Continuar" alertas

"continue" alertas são geralmente avisos ou erros não críticos. Quando Serviços de cálculo do Excel gera uma alerta "Continuar", a operação continua. Esses alertas são retornadas como sem argumentos ? uma estrutura com os vários alerta campos. Para obter mais informações, consulte os tópicos de referência classe Status no namespace Microsoft.Office.Excel.Server.WebServices Microsoft.Office.Excel.Server.WebServices.

Exceções à catch

Você deve capturar erros específicos para Serviços de cálculo do Excel que você conhece o usuário pode causar. De exemplo, se seu aplicativo solicita o usuário para tipo de caminho para um pasta de trabalho, o usuário pode tipo o caminho errado ou selecione um pasta de trabalho que não existe. Como o desenvolvedor, você não poderá controle quais tipos de usuário, mas você pode controle experiência do usuário quando um usuário acidentalmente misspells um nome arquivo pasta de trabalho.

Você deve capturar as exceções SOAP (ou seja, os alertas "parar") no seu codificar. Para alertas "Continuar", a codificar chamado pode escolher para ignorar ou revisar a alerta informações.

Códigos de erro

Para tornar mais fácil para o desenvolvedor para capturar as condições de erro específica, uma alerta Serviços de cálculo do Excel esecsshort possui um associado código de erro. O serviço da Web, em seguida, retorna o erro usando as propriedades a partir de SoapException classe SoapException.

Para obter mais informações, consulte o tópico "Classe SoapException" na Microsoft .NET Framework SDK documentação.

Manipulação de exceção

Se seu aplicativo (that is, seu cliente SOAP) envia uma solicitação para um serviço da Web que o serviço não consegue processo, o serviço retorna uma exceção SOAP para o cliente. Tratamento de exceções geradas por Serviços Web do Excel é uma parte importante dos aplicativos que você desenvolve, pois você poderá retornar informações específicas ao usuários ao ocorrer erros. Manipulação de exceção também pode ajudar a tornar o usuário experiência melhor quando algo inesperado acontece no seu aplicativo.

Para obter informações gerais sobre manipulação de exceção, consulte "Tratamento e Throwing exceções" na Microsoft .NET Framework SDK documentação.

Consulte também

Outros recursos

Etapa 3: acessar o serviço da Web
Etapa 4: Criando e testando o aplicativo
Walkthrough: desenvolvendo um aplicativo personalizado usando os serviços da Web Excel
Acessando o SOAP API
Códigos de erro dos serviços Excel
Como a: relação de confiança locais de pasta de trabalho com scripts