Поделиться через


Пошаговое руководство. Разработка настраиваемого приложения с помощью веб-служб Excel

Дата последнего изменения: 24 марта 2010 г.

Применимо к: SharePoint Server 2010

В этом разделе представлено пошаговое руководство, в котором описывается порядок доступа к веб-службам Excel из приложения, созданного с помощью Microsoft Visual C#.

В этом пошаговом руководстве рассматривается порядок выполнения следующих действий:

  • Создание клиентского приложения с использованием шаблона проекта консольного приложения Visual Studio.

  • Добавление веб-ссылки для веб-служб Excel.

  • Написание кода для доступа к веб-службе. В этом разделе приведены инструкции по открытию рабочей книги, получению идентификатора сеанса, передаче учетных данных по умолчанию, получению сведений о версии веб-службы, определению объекта координат диапазона, получению диапазона, в котором используется объект координат, а также по закрытию рабочей книги и перехвату исключения SOAP.

  • Тестирование и запуск консольного приложения в режиме отладки.

Клиентское консольное приложение — это всего лишь один из возможных способов доступа к веб-службе. Гораздо чаще для этих целей используются серверные приложения, например приложения Microsoft ASP.NET. В этом пошаговом руководстве для большего удобства используется пример консольного приложения, основное внимание в котором уделяется вопросам использования API-интерфейса веб-службы Excel.

Необходимые компоненты

Для выполнения этой процедуры требуется установить следующие компоненты:

  • Microsoft SharePoint Server 2010.

  • Visual Studio или аналогичное средство разработки, совместимое с платформой Microsoft .NET Framework.

  • Достаточные разрешения (как минимум разрешения на просмотр) для доступа к веб-службам Excel на компьютере, на котором располагаются SharePoint Server 2010.

    ПримечаниеПримечание

    Дополнительные сведения о разрешениях рабочих книг см. в следующем разделе "Разрешения рабочих книг".

  • Пример рабочей книги, установленный на локальном диске или в локальной библиотеке документов SharePoint.

  • Надежное расположение для хранения рабочих книг, доступ к которым будет осуществляться с помощью веб-служб Excel. Если рабочие книги хранятся не в надежном расположении, вызовы веб-служб Excel для открытия таких книг завершаются сбоем. В этом пошаговом руководстве подразумевается, что рабочая книга размещается на локальном компьютере.

    ПримечаниеПримечание

    Дополнительные сведения об определении надежного расположения см. в статьях Инструкции по определению надежного расположения и How to: Trust Workbook Locations Using Script.

  • Создание рабочей книги с помощью приложения Excel.

  • Сохранение рабочей книги в формате XLSX или XLSB.

В рабочей книге, используемой в этом примере, представлен лист "Sheet1", в котором содержатся 11 столбцов и 19 строк. В каждой ячейке в диапазоне от A1 до K19 содержится числовое значение, например, 4245,955, 6960,673 и т. д.

Разрешения рабочих книг

  • Для получения рабочей книги целиком (например, с помощью метода GetWorkbook) вызывающий объект должен обладать разрешениями на ее открытие.

  • Для вызова метода GetApiVersion разрешения не требуются.

  • Для остальных методов веб-служб Excel вызывающему объекту требуются разрешения на просмотр (в Microsoft SharePoint Foundation) или чтение (на общем файловом ресурсе) рабочей книги.

    ПримечаниеПримечание

    Дополнительные сведения об установке разрешений см. в документации SharePoint Foundation.

См. также

Задачи

Шаг 1. Создание проекта клиента веб-службы

Этап 2. Добавление веб-ссылки

Этап 3. Получение доступа к веб-службе

Этап 4. Построение и тестирование приложения

Концепции

Доступ к API-интерфейсу SOAP

Excel Services Alerts

Известные проблемы и советы по работе со службами Excel

Вызовы SOAP с замыканием на себя и прямая привязка