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

Обновлен: Июль 2008

Применение
Сведения, приведенные в данном разделе, относятся только к указанным проектам Visual Studio Tools for Office и версиям Microsoft Office. Тип проекта Проекты уровня документа Проекты уровня приложения Версия Microsoft Office Excel 2003 Excel 2007 Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов.

Существует несколько способов сохранить книгу. Можно сохранить книгу, не изменяя путь. Если книга ранее не сохранялась, следует сохранить книгу, указав путь. Если путь не указан в явном виде, Microsoft Office Excel сохраняет файл в текущей папке, используя имя, полученное файлом во время создания. Можно также сохранить копию книги, не изменяя открытую книгу в памяти.

Сохранение книги без изменения пути

Сохранение книги, связанной с настройкой на уровне документа

• Вызовите метод Save класса ThisWorkbook.

  Me.Save()
  

  this.Save();
  

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

• Чтобы сохранить активную книгу, вызовите метод Save. Чтобы использовать следующий пример кода, запустите его из класса ThisAddIn в проекте уровня приложения для Excel.

  Me.Application.ActiveWorkbook.Save()
  

  this.Application.ActiveWorkbook.Save();
  

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

Указанную книгу можно сохранить в новом месте или под новым именем, дополнительно указывая при этом формат файла, пароль, режим доступа и прочее.

Примечание.
Перед сохранением книги с новым путем, может понадобиться задать для свойства DisplayAlerts значение False, так как сохранение в некоторых форматах требует дополнительного вмешательства. Присвоение значения False этому свойству приводит к тому, что Excel использует параметры, заданные по умолчанию.

Сохранение книги, связанной с настройкой на уровне документа

• Вызовите метод SaveAs класса ThisWorkbook. Чтобы использовать следующий пример кода, выполните его в классе ThisWorkbook.

  Me.SaveAs("C:\Book1.xml")
  

  this.SaveAs(@"C:\Book1.xml", missing,
      missing, missing, missing, missing, Excel.XlSaveAsAccessMode.xlNoChange,
      missing, missing, missing, missing, missing);
  

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

• Чтобы сохранить активную книгу с новым путем, вызовите метод SaveAs. Чтобы использовать следующий пример кода, запустите его из класса ThisAddIn в проекте уровня приложения для Excel.

  Me.Application.ActiveWorkbook.SaveAs("C:\Test\Book1.xml")
  

  this.Application.ActiveWorkbook.SaveAs(@"C:\Test\Book1.xml",
      missing, missing, missing, missing, missing, 
      Excel.XlSaveAsAccessMode.xlNoChange, missing, missing, missing, 
      missing, missing);
  

Сохранение копии книги

Можно также сохранить копию книги в файл, не изменяя открытую книгу в памяти. Этот метод полезен для создания резервной копии без изменения местоположения книги.

Сохранение книги, связанной с настройкой на уровне документа

• Вызовите метод SaveCopyAs класса ThisWorkbook. Чтобы использовать следующий пример кода, выполните его в классе ThisWorkbook.

  Me.SaveCopyAs("C:\Book1.xls")
  

  this.SaveCopyAs(@"C:\Book1.xls");
  

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

• Для сохранения копии активной книги вызовите метод SaveCopyAs. Чтобы использовать следующий пример кода, запустите его из класса ThisAddIn в проекте уровня приложения для Excel.

  Me.Application.ActiveWorkbook.SaveCopyAs("C\Book1.xls")
  

  this.Application.ActiveWorkbook.SaveCopyAs(@"C\Book1.xls");
  

Отказоустойчивость

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

См. также

Задачи

Практическое руководство. Активация Workbooks

Практическое руководство. Закрытие книг

Основные понятия

Работа с книгами

Ведущий элемент книги

Программные ограничения ведущих элементов и элементов управления ведущего приложения

Общие сведения о необязательных параметрах в решениях Office

Общие сведения о ведущих элементах и элементах управления ведущего приложения

Журнал изменений

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