DocumentBase.SaveAs - метод
Сохраняет документ с новым именем или форматом. Некоторые аргументы для данного метода соответствуют параметрам в диалоговом окне Сохранить как.
Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v4.0.Utilities (в Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
Синтаксис
'Декларация
Public Sub SaveAs ( _
ByRef fileName As Object, _
ByRef fileFormat As Object, _
ByRef lockComments As Object, _
ByRef password As Object, _
ByRef addToRecentFiles As Object, _
ByRef writePassword As Object, _
ByRef readOnlyRecommended As Object, _
ByRef embedTrueTypeFonts As Object, _
ByRef saveNativePictureFormat As Object, _
ByRef saveFormsData As Object, _
ByRef saveAsAOCELetter As Object, _
ByRef encoding As Object, _
ByRef insertLineBreaks As Object, _
ByRef allowSubstitutions As Object, _
ByRef lineEnding As Object, _
ByRef addBiDiMarks As Object _
)
public void SaveAs(
ref Object fileName,
ref Object fileFormat,
ref Object lockComments,
ref Object password,
ref Object addToRecentFiles,
ref Object writePassword,
ref Object readOnlyRecommended,
ref Object embedTrueTypeFonts,
ref Object saveNativePictureFormat,
ref Object saveFormsData,
ref Object saveAsAOCELetter,
ref Object encoding,
ref Object insertLineBreaks,
ref Object allowSubstitutions,
ref Object lineEnding,
ref Object addBiDiMarks
)
Параметры
- fileName
Тип: System.Object%
Имя документа.Текущая папка и имя файла являются значениями по умолчанию.Если документ ранее не сохранялся, используется имя по умолчанию (например, Doc1.doc).Если документ с указанным именем уже существует, происходит перезапись документа без предварительного предупреждения пользователя.
- fileFormat
Тип: System.Object%
Формат, в котором сохраняется документ.Допускается любое значение WdSaveFormat.Чтобы сохранить документ в другом формате, следует указать соответствующее значение для свойства SaveFormat.
- lockComments
Тип: System.Object%
Значение true используется, чтобы заблокировать возможность добавления примечаний в документ.Значение по умолчанию — false.
- password
Тип: System.Object%
Строка пароля для открытия документа.(См. примечания ниже).
- addToRecentFiles
Тип: System.Object%
Значение trueиспользуется, чтобы добавить документ в список недавно использовавшихся файлов в меню Файл.Значение по умолчанию — true.
- writePassword
Тип: System.Object%
Строка пароля для сохранения изменений в документе.(См. примечания ниже).
- readOnlyRecommended
Тип: System.Object%
Значение true используется, чтобы приложением Microsoft Office Word предлагался статус «только для чтения» при каждом открытии документа.Значение по умолчанию — false.
- embedTrueTypeFonts
Тип: System.Object%
Чтобы сохранить в документе шрифты True Type, используется значение true.Если аргумент EmbedTrueTypeFonts опущен, ему присваивается значение свойства EmbedTrueTypeFonts.
- saveNativePictureFormat
Тип: System.Object%
Если из другой платформы (например, Macintosh) импортируются графические объекты, значение true используется, чтобы сохранить только Windows-версию импортированной графики.
- saveFormsData
Тип: System.Object%
Значение true используется, чтобы сохранить данные, введенные пользователем в форму, как запись данных.
- saveAsAOCELetter
Тип: System.Object%
Если для документа существует присоединенная рассылка, значение true используется, чтобы сохранить документ как письмо AOCE (рассылка сохраняется).
- encoding
Тип: System.Object%
MsoEncoding.Кодовая страница или набор знаков, которые необходимо использовать для документов, сохраняемых как закодированные текстовые файлы.По умолчанию используется системная кодовая страница.
- insertLineBreaks
Тип: System.Object%
Если документ сохраняется как текстовый файл, значение true используется, чтобы вставить разрывы страниц в конце каждой текстовой строки.
- allowSubstitutions
Тип: System.Object%
Если документ сохраняется как текстовый файл, значение true позволяет приложению Word заменять некоторые знаки на похожий текст.Например, отображение знака авторского права как (с). Значение по умолчанию — false.
- lineEnding
Тип: System.Object%
Способ, которым приложение Word помечает разрыв строк и абзацев в документе, сохраняемом как текстовый файл.Допускается любое значение WdLineEndingType.
- addBiDiMarks
Тип: System.Object%
Значение true используется, чтобы добавить в выходной файл управляющие знаки для сохранения двунаправленного макета текста исходного документа.
Заметки
Следует избегать использования в приложениях жестко заданных паролей. Если в процедуре необходим пароль, нужно запросить его у пользователя, сохранить в переменной и затем использовать эту переменную в программном коде.
Необязательные параметры
Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.
Примеры
В приведенном ниже примере кода с помощью метода SaveAs документ сохраняется в новый файл с именем myfile.doc в формате RTF. Чтобы использовать этот пример, запустите его из класса ThisDocument в проекте уровня документа.
Private Sub DocumentSaveAs()
Me.SaveAs(FileName:="myfile.doc", FileFormat:=Word.WdSaveFormat.wdFormatRTF, _
LockComments:=False, AddToRecentFiles:=True, ReadOnlyRecommended:=False, _
EmbedTrueTypeFonts:=False, SaveNativePictureFormat:=True, _
SaveFormsData:=True, SaveAsAOCELetter:=False, _
Encoding:=Office.MsoEncoding.msoEncodingUSASCII, _
InsertLineBreaks:=False, AllowSubstitutions:=False, _
LineEnding:=Word.WdLineEndingType.wdCRLF, _
AddBiDiMarks:=False)
End Sub
private void DocumentSaveAs()
{
object FileName = "myfile.doc";
object FileFormat = Word.WdSaveFormat.wdFormatRTF;
object LockComments = false;
object AddToRecentFiles = true;
object ReadOnlyRecommended = false;
object EmbedTrueTypeFonts = false;
object SaveNativePictureFormat = true;
object SaveFormsData = true;
object SaveAsAOCELetter = false;
object Encoding = Office.MsoEncoding.msoEncodingUSASCII;
object InsertLineBreaks = false;
object AllowSubstitutions = false;
object LineEnding = Word.WdLineEndingType.wdCRLF;
object AddBiDiMarks = false;
if (this.SaveFormat == (int)Word.WdSaveFormat.wdFormatDocument)
{
this.SaveAs(ref FileName, ref FileFormat, ref LockComments,
ref missing, ref AddToRecentFiles, ref missing,
ref ReadOnlyRecommended, ref EmbedTrueTypeFonts,
ref SaveNativePictureFormat, ref SaveFormsData,
ref SaveAsAOCELetter, ref Encoding, ref InsertLineBreaks,
ref AllowSubstitutions, ref LineEnding, ref AddBiDiMarks);
}
}
Безопасность платформы .NET Framework
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.