Passo a passo: desenvolvendo um aplicativo personalizado usando Web Services do Excel

A explicação passo a passo desta seção descreve o processo para acessar Excel Web Services de um aplicativo criado com o Microsoft Visual C#.

Durante esta explicação passo a passo, você aprenderá como:

  • Crie um aplicativo de cliente usando o modelo de projeto de aplicativo de Console do Visual Studio.

  • Adicione uma referência da Web para Excel Web Services.

  • Escreva código para acessar o serviço da Web. Você aprenderá como abrir uma pasta de trabalho, obter a identificação da sessão, passe as credenciais padrão, obter informações de versão do serviço Web, definir o objeto coordinate intervalo, obter o intervalo que usa o objeto coordinate intervalo, fechar a pasta de trabalho e capturar a exceção SOAP.

  • Testar e executar o aplicativo de console no modo de depuração.

Um aplicativo de console do cliente é apenas uma maneira de acessar o serviço Web. Uma maneira mais comum seria usar aplicativos de servidor, como aplicativos Microsoft ASP.NET. Esta explicação passo a passo usa um exemplo de aplicativo de console para simplificar, para enfocar os aspectos da API Excel Web Services .

Pré-requisitos

In order to complete this walkthrough, you will need:

  • Microsoft SharePoint Server 2010.

  • Visual Studio ou uma ferramenta semelhante de desenvolvimento compatível com o Microsoft.NET Framework.

  • Permissões suficientes (no mínimo, permissões de "exibição") para poder acessar Excel Web Services no computador onde se encontra SharePoint Server 2010 .

    Observação

    Para obter mais informações sobre permissões de pasta de trabalho, consulte a seção seguinte, "Permissões de pasta de trabalho".

  • Uma pasta de trabalho de exemplo instalada em uma unidade local ou biblioteca de documentos do SharePoint local.

  • Um local confiável para armazenar as pastas de trabalho que você deseja acessar usando Excel Web Services. Se as pastas de trabalho não são armazenadas em um local confiável, as chamadas Excel Web Services para abrir a pasta de trabalho não funcionará. Esta explicação passo a passo presume que a pasta de trabalho está presente no computador local.

    Observação

    Para obter informações sobre como confiar em um local, consulte Como confiar em um local e como confiar em locais de pasta de trabalho usando script.

  • Para criar a pasta de trabalho usando o Excel.

  • Para salvar a pasta de trabalho como arquivos. xlsx ou. xlsb.

A pasta de trabalho usada neste exemplo possui uma planilha chamada "Sheet1". A planilha tem 19 linhas e 11 colunas. Cada célula de A1 a K19 contém um valor numérico — por exemplo, 4245.955, 6960.673 e assim por diante.

Permissões da pasta de trabalho

  • Para obter a pasta de trabalho inteira (por exemplo, chamando o método GetWorkbook ), o chamador precisa da permissão "aberto" fr a pasta de trabalho.

  • Para chamar o método GetApiVersion, não é necessária nenhuma permissão.

  • Para o restante dos métodos Excel Web Services , o chamador precisa "Exibir" permissão (em Microsoft SharePoint Foundation) ou "leitura" permissão (em um compartilhamento de arquivo) para a pasta de trabalho.

    Observação

    Para obter mais informações sobre como definir permissões, consulte a documentação do SharePoint Foundation .

Confira também