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

Статья
04/28/2010

Обновлен: Ноябрь 2007

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

Сведения, приведенные в данном разделе, относятся только к указанным проектам Visual Studio Tools for Office и версиям Microsoft Office.

Тип проекта

Проекты уровня документа
Проекты уровня приложения

Версия Microsoft Office

Word 2003
Word 2007

Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов.

Существует несколько способов сохранить документы Microsoft Office Word. Можно сохранить документ без изменения имени документа или сохранить с новым именем.

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

Чтобы сохранить документ, связанный с настройкой на уровне документа

Вызовите метод Save класса Microsoft.Office.Tools.Word.Document. Чтобы воспользоваться следующим примером кода, выполните его из класса ThisDocument своего проекта.
```
Me.Save()
```
```
this.Save();
```

Чтобы сохранить активный документ

Вызовите для активного документа метод _Document.Save. Чтобы воспользоваться следующим примером кода, выполните его из класса ThisDocument или ThisAddIn своего проекта.
```
Me.Application.ActiveDocument.Save()
```
```
this.Application.ActiveDocument.Save();
```

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

Чтобы сохранить документ, указанный по имени

Укажите имя документа в качестве аргумента коллекции Documents. Чтобы воспользоваться следующим примером кода, выполните его из класса ThisDocument или ThisAddIn своего проекта.
```
Me.Application.Documents("C:\Test\NewDocument.doc").Save()
```
```
object fileName = @"C:\Test\NewDocument.doc"; 
this.Application.Documents.get_Item(ref fileName).Save(); 
```

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

Чтобы сохранить документ с новым именем, используйте метод SaveAs. Можно использовать этот метод ведущего элемента Microsoft.Office.Tools.Word.Document в проекте на уровне документа Word, либо метод собственного объекта Microsoft.Office.Interop.Word.Document в любом проекте Word. Этот метод требует указания нового имени файл, другие аргументы необязательны.

Примечание.
Если метод SaveAs, открывающий диалоговое окно, вызывается внутри обработчика событий DocumentBeforeSave класса ThisDocument и параметру Cancel события присваивается значение false, то приложение может неожиданно завершиться. Если параметру Cancel присвоить значение true, то появится сообщение об ошибке, указывающее, что автосохранение было отключено.

Если метод SaveAs, открывающий диалоговое окно, вызывается внутри обработчика событий DocumentBeforeSave класса ThisDocument и параметру Cancel события присваивается значение false, то приложение может неожиданно завершиться. Если параметру Cancel присвоить значение true, то появится сообщение об ошибке, указывающее, что автосохранение было отключено.

Чтобы сохранить с новым именем документ, связанный с настройкой уровня документа

Вызовите метод SaveAs класса Microsoft.Office.Tools.Word.Document, указав полный путь к документу. Если файл с указанным именем уже существует в папке, он будет перезаписан без запроса подтверждения. Чтобы воспользоваться следующим примером кода, выполните его из класса ThisDocument своего проекта.

Примечание.
Метод SaveAs вызовет исключение, если каталог назначения не существует или при сохранении файла встретились другие проблемы. Рекомендуется заключать метод SaveAs или вызывающий его метод в блок try…catch.

Me.SaveAs("C:\Test\NewDocument.doc")

object fileName = @"C:\Test\NewDocument.doc"; 

this.SaveAs(ref fileName,
    ref missing, ref missing, ref missing, ref missing, ref missing,
    ref missing, ref missing, ref missing, ref missing, ref missing,
    ref missing, ref missing, ref missing, ref missing, ref missing);

Чтобы сохранить обычный документ с новым именем

Вызовите метод SaveAs сохраняемого документа Microsoft.Office.Interop.Word.Document, указав полный путь к документу. Если файл с указанным именем уже существует в папке, он будет перезаписан без запроса подтверждения.

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

Примечание.
Метод SaveAs вызовет исключение, если каталог назначения не существует или при сохранении файла встретились другие проблемы. Рекомендуется заключать метод SaveAs или вызывающий его метод в блок try…catch.

Me.Application.ActiveDocument.SaveAs("C:\Test\NewDocument.doc")

object fileName = @"C:\Test\NewDocument.doc";

this.Application.ActiveDocument.SaveAs(ref fileName,
    ref missing, ref missing, ref missing, ref missing, ref missing,
    ref missing, ref missing, ref missing, ref missing, ref missing,
    ref missing, ref missing, ref missing, ref missing, ref missing);

Компиляция кода

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

Чтобы сохранить документ с прежним именем, на диске C в каталоге Test должен существовать документ NewDocument.doc.
Чтобы сохранить документ с новым именем, на диске C должен существовать каталог с именем Test.