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

Сохранение книги на сервер для подготовки к программному доступу

  • Статья

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

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

В данном примере показано, как сохранить книгу Excel на сервер и подготовить ее к программному доступу. Выполните указанные ниже действия.

  1. Создайте книгу с именованными диапазонами.

  2. Сохраните книгу в надежное расположение библиотеки SharePoint.

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

    Предполагается, что библиотека документов SharePoint уже создана и для нее выбрано надежное расположение. Дополнительные сведения см. в разделе Инструкции по определению надежного расположения.

  3. Программно задайте значения для листа, именованного диапазона и ячейки с помощью метода Excel SetCellA1. Значения передаются через аргументы, т. е. args [1] и args [2]:

    status = xlServices.SetCellA1(sessionId, String.Empty, args[1], args[2]);

    status = xlServices.SetCellA1(sessionId, String.Empty, args(1), args(2))

Значения аргументов args [1] и args [2] можно указать через веб-форму или в командной строке:

GetSnapshot.exe http://MyServer002/MyTrustedDocumentLibrary/TestMyParam.xlsx MyParam28 > MySnapshot.xlsx

В данном примере args [1] принимает значение MyParam, аргумент args [2] — значение 28, а GetSnapshot.exe — это имя создаваемого приложения. Пример программы см. в разделе Получение рабочей книги целиком или ее снимка.

Создание именованного диапазона

  1. Запустите Excel.

  2. Переименуйте Лист1 в MyParamSheet.

  3. В ячейку B2 введите 20.

  4. В ячейку B3 введите =2+B2.

  5. Выделите содержимое ячейки B3 полужирным шрифтом.

  6. Преобразуйте ячейку B2 в именованный диапазон:

    1. На ленте откройте вкладку Формулы и выделите ячейку B2 щелчком мыши.

    2. В группе Определенные имена нажмите кнопку Присвоить имя.

    3. В диалоговом окне Создание имени введите в текстовое поле Имя текст MyParam.

  7. Сохраните книгу в любую папку на жестком диске, присвоив ей имя TestMyParam.xlsx.

Сохранение книги в библиотеку SharePoint

  1. В меню Файл выберите Сохранить и отправить и затем нажмите кнопку Сохранить в SharePoint.

  2. В диалоговом окне Сохранить в SharePoint нажмите кнопку Параметры публикации.

  3. В диалоговом окне Параметры публикации на вкладке Отображение установите флажок Вся книга.

  4. Нажмите кнопку Параметры.

  5. Нажмите кнопку Добавить.

  6. В списке Добавление параметров должен появиться пункт MyParam. Установите флажок MyParam.

  7. Нажмите кнопку ОК. В списке Параметры должен появиться пункт MyParam.

  8. Нажмите кнопку ОК.

  9. В диалоговом окне Сохранение в SharePoint нажмите кнопку Сохранить как.

  10. В диалоговом окне Сохранить как снимите флажок Открыть в Excel в браузере.

  11. В поле Имя файла введите путь к надежной библиотеке документов SharePoint, куда необходимо сохранить книгу. Например: http://мой_сервер_002/MyDocumentLibrary/TestParam.xlsx.

  12. Нажмите кнопку Сохранить.

Программное задание значений

  1. Ниже приведена сигнатура метода SetCellA1 в Excel:

    public void SetCellA1 (
string sessionId,
string sheetName,
string rangeName,
Object cellValue,
Out Status[] status
)

    Public Sub SetCellA1(ByVal sessionId As String,
              ByVal sheetName As String, 
             ByVal rangeName As String, 
             ByVal cellValue As Object, 
             Out ByVal status() As Status)
End Sub

    Задайте в методе SetCellA1 значения для листа, именованного диапазона и ячейки следующим образом:

    // Set a value into a cell.
status = xlSrv.SetCellA1(sessionId, String.Empty, args[1], args[2]);

  2. В приведенном выше коде:

    • args [1] — имя именованного диапазона, в данном примере MyParam.

    • args [2] — значение, которое необходимо задать для ячейки. Ячейка, в которую будет введено значение, является именованным диапазоном в args [1] с именем MyParam.

  3. В командной строке значения в аргументах можно передать следующим образом:

    GetSnapshot.exe http://мой_сервер_002/моя_надежная_библиотека_документов/TestMyParam.xlsx MyParam 28 > MySnapshot.xlsx

  4. При создании моментального снимка книги будет получен следующий результат:

    • В ячейке B2 (с именованным диапазоном MyParam) теперь будет храниться значение, переданное через программу, а именно 28.

    • В ячейке B3 появится новое вычисленное значение 30.

    • В ячейке B3 не будет отображаться исходная формула, "=2+B2".

    • Для ячейки B3 сохранится формат шрифта (полужирный).

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

Дополнительные сведения о моментальных снимках см. в разделе Получение рабочей книги целиком или ее снимка. Дополнительные сведения о методе SetCellA1 см. в справочной документации по веб-службам Excel. Пространство имен веб-службы — Microsoft.Office.Excel.Server.WebServices.

См. также

Задачи

Практическое руководство. Сохранение из клиента Excel на сервер

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

Ссылка

Microsoft.Office.Excel.Server.WebServices

Концепции

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

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

Excel Services Alerts