Пошаговое руководство по разработке собственного приложения с помощью веб-служб ExcelWalkthrough: Developing a Custom Application Using Excel Web Services

В этом разделе представлено пошаговое руководство, в котором описывается порядок доступа к веб-службам Веб-службы Excel из приложения, созданного с помощью Microsoft Visual C#.The walkthrough in this section describes the process for accessing Excel Web Services from an application created with Microsoft Visual C#.

В этом пошаговом руководстве рассматривается порядок выполнения следующих действий:During this walkthrough, you will learn how to:

  • Создание клиентского приложения с использованием шаблона проекта консольного приложения Visual Studio.Create a client application using the Visual Studio Console Application project template.

  • Добавление веб-ссылки для веб-служб Веб-службы Excel.Add a Web reference for Excel Web Services.

  • Написание кода для доступа к веб-службе. В этом разделе приведены инструкции по открытию рабочей книги, получению идентификатора сеанса, передаче учетных данных по умолчанию, получению сведений о версии веб-службы, определению объекта координат диапазона, получению диапазона, в котором используется объект координат, а также по закрытию рабочей книги и перехвату исключения SOAP.Write code to access the Web service. You will learn how to open a workbook, get the session ID, pass in the default credentials, get Web service version information, define the range coordinate object, get the range that uses the range coordinate object, close the workbook, and catch the SOAP exception.

  • Тестирование и запуск консольного приложения в режиме отладки.Test and run the console application in debug mode.

Клиентское консольное приложение это всего лишь один из возможных способов доступа к веб-службе. Гораздо чаще для этих целей используются серверные приложения, например приложения Microsoft ASP.NET. В этом пошаговом руководстве для большего удобства используется пример консольного приложения, основное внимание в котором уделяется вопросам использования API-интерфейса веб-службы Веб-службы Excel.A client console application is just one way to access the Web service. A more common way would be to use server applications, such as Microsoft ASP.NET applications. This walkthrough uses a console application example for simplicity, to focus on the Excel Web Services API aspects.

Необходимые условияPrerequisites

Для выполнения этой процедуры требуется установить следующие компоненты:In order to complete this walkthrough, you will need:

  • Microsoft SharePoint Server 2010.Microsoft SharePoint Server 2010.

  • Visual Studio или аналогичное средство разработки, совместимое с Microsoft .NET Framework.Visual Studio or a similar Microsoft .NET Framework-compatible development tool.

  • Достаточные разрешения (как минимум разрешения на просмотр) для доступа к веб-службам Веб-службы Excel на компьютере, на котором располагаются SharePoint Server 2010.Sufficient permissions (at the very least, "view" permissions) to be able to access Excel Web Services on the computer where SharePoint Server 2010 is located.

    Примечание

    Дополнительные сведения о разрешениях рабочих книг см. в следующем разделе "Разрешения рабочих книг".For more information about workbook permissions, see the following section, "Workbook Permissions."

  • Пример рабочей книги, установленный на локальном диске или в локальной библиотеке документов SharePoint.A sample workbook installed on a local drive or local SharePoint document library.

  • Надежное расположение для хранения рабочих книг, доступ к которым будет осуществляться с помощью веб-служб Веб-службы Excel. Если рабочие книги хранятся не в надежном расположении, вызовы веб-служб Веб-службы Excel для открытия таких книг завершаются сбоем. В этом пошаговом руководстве подразумевается, что рабочая книга размещается на локальном компьютере.A trusted location to store the workbooks that you want to access using Excel Web Services. If the workbooks are not stored in a trusted location, the Excel Web Services calls to open the workbook will fail. This walkthrough assumes the workbook is present on the local computer.

    Примечание

    Информацию о том, как сделать расположение доверенным, см. здесь и здесь.For information about how to trust a location, see How to: Trust a Location and How to: Trust Workbook Locations Using Script.

  • Возможность создания книги с помощью Excel.To create the workbook using Excel.

  • Сохранение рабочей книги в формате XLSX или XLSB.To save the workbook as .xlsx or .xlsb files.

В рабочей книге, используемой в этом примере, представлен лист "Sheet1", в котором содержатся 11 столбцов и 19 строк. В каждой ячейке в диапазоне от A1 до K19 содержится числовое значение, например, 4245,955, 6960,673 и т. д.The workbook used in this example has a worksheet named "Sheet1". The worksheet has 11 columns and 19 rows. Each cell from A1 to K19 contains a numeric value—for example, 4245.955, 6960.673, and so on.

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

  • Для получения рабочей книги целиком (например, с помощью метода GetWorkbook) вызывающий объект должен обладать разрешениями на ее открытие.To get the entire workbook (for example, by calling the GetWorkbook method), the caller needs "open" permission fr the workbook.

  • Для вызова метода GetApiVersion разрешения не нужны.To call the GetApiVersion method, no permission is necessary.

  • Для остальных методов веб-служб Веб-службы Excel вызывающему объекту требуются разрешения на просмотр (в Microsoft SharePoint Foundation) или чтение (на общем файловом ресурсе) рабочей книги.For the rest of the Excel Web Services methods, the caller needs "view" permission (in Microsoft SharePoint Foundation) or "read" permission (on a file share) for the workbook.

    Примечание

    Дополнительные сведения об установке разрешений см. в документации SharePoint Foundation.For more information about setting permissions, see the SharePoint Foundation documentation.

См. такжеSee also