DocumentBase.SaveAs2 Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Сохраняет документ с новым именем или форматом. Некоторые аргументы для данного метода соответствуют параметрам в диалоговом окне Сохранить как.
public void SaveAs2 (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, ref object compatibilityMode);
member this.SaveAs2 : obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj -> unit
Public Sub SaveAs2 (Optional ByRef fileName As Object, Optional ByRef fileFormat As Object, Optional ByRef lockComments As Object, Optional ByRef password As Object, Optional ByRef addToRecentFiles As Object, Optional ByRef writePassword As Object, Optional ByRef readOnlyRecommended As Object, Optional ByRef embedTrueTypeFonts As Object, Optional ByRef saveNativePictureFormat As Object, Optional ByRef saveFormsData As Object, Optional ByRef saveAsAOCELetter As Object, Optional ByRef encoding As Object, Optional ByRef insertLineBreaks As Object, Optional ByRef allowSubstitutions As Object, Optional ByRef lineEnding As Object, Optional ByRef addBiDiMarks As Object, Optional ByRef compatibilityMode As Object)
Параметры
- fileName
- Object
Имя документа. Текущая папка и имя файла являются значениями по умолчанию. Если документ ранее не сохранялся, используется имя по умолчанию (например, Doc1.doc). Если документ с указанным именем уже существует, происходит перезапись документа без предварительного предупреждения пользователя.
- fileFormat
- Object
Формат, в котором сохраняется документ. Допускается любое значение WdSaveFormat. Чтобы сохранить документ в другом формате, следует указать соответствующее значение для свойства SaveFormat.
- lockComments
- Object
Значение true
используется, чтобы заблокировать возможность добавления примечаний в документ. Значение по умолчанию — false
.
- password
- Object
Строка пароля для открытия документа. (См. примечания ниже).
- addToRecentFiles
- Object
Значение true
используется, чтобы добавить документ в список недавно использовавшихся файлов в меню Файл. Значение по умолчанию — true
.
- writePassword
- Object
Строка пароля для сохранения изменений в документе. (См. примечания ниже).
- readOnlyRecommended
- Object
Значение true
используется, чтобы приложением Microsoft Office Word предлагался статус «только для чтения» при каждом открытии документа. Значение по умолчанию — false
.
- embedTrueTypeFonts
- Object
Чтобы сохранить в документе шрифты True Type, используется значение true
. Если этот параметр опущен EmbedTrueTypeFonts
, аргумент предполагает значение EmbedTrueTypeFonts свойства .
- saveNativePictureFormat
- Object
Если из другой платформы (например, Macintosh) импортируются графические объекты, значение true
используется, чтобы сохранить только Windows-версию импортированной графики.
- saveFormsData
- Object
Значение true
используется, чтобы сохранить данные, введенные пользователем в форму, как запись данных.
- saveAsAOCELetter
- Object
Если для документа существует присоединенная рассылка, значение true
используется, чтобы сохранить документ как письмо AOCE (рассылка сохраняется).
- encoding
- Object
MsoEncoding. Кодовая страница или набор знаков, которые необходимо использовать для документов, сохраняемых как закодированные текстовые файлы. По умолчанию используется системная кодовая страница.
- insertLineBreaks
- Object
Если документ сохраняется как текстовый файл, значение true
используется, чтобы вставить разрывы страниц в конце каждой текстовой строки.
- allowSubstitutions
- Object
Если документ сохраняется как текстовый файл, значение true
позволяет приложению Word заменять некоторые знаки на похожий текст. Например, отображение знака авторского права как (с). Значение по умолчанию — false
.
- lineEnding
- Object
Способ, которым приложение Word помечает разрыв строк и абзацев в документе, сохраняемом как текстовый файл. Может быть любым значение объекта T:Microsoft.Office.Interop.Word.WdLineEndingType.
- addBiDiMarks
- Object
Значение true для добавления в выходной файл управляющих символов для сохранения двунаправленного структуры текста исходного документа.
- compatibilityMode
- Object
Одно из значений Microsoft.Office.Interop.Word.WdCompatibilityMode
, указывающее режим совместимости, используемый Word 2013 и Word 2010 при открытии документа.
Исключения
Это свойство используется в проекте Word 2007.
Примеры
В следующем примере кода используется <xref:Microsoft.Office.Tools.Word.DocumentBase.SaveAs%2A> метод для сохранения документа в формате RTF с использованием нового имени файла myfile.docx. Чтобы использовать этот пример, запустите его из ThisDocument
класса в проекте уровня документа.
private void DocumentSaveAs()
{
object FileName = "myfile.docx";
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);
}
}
Private Sub DocumentSaveAs()
Me.SaveAs(FileName:="myfile.docx", 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
Комментарии
Избегайте использования жестко заданных паролей в приложениях. Если в процедуре требуется пароль, запросите пароль у пользователя, сохраните его в переменной, а затем используйте переменную в коде.
Примечание
Этот метод отображается в IntelliSense в проектах Word 2007, предназначенных для платформа .NET Framework 4. Однако это свойство нельзя использовать в проектах Word 2007.
Необязательные параметры
Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.