WorkbookBase.SaveAs - метод
Сохраняет изменения в книге в другой файл.
Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v4.0.Utilities (в Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Синтаксис
'Декларация
Public Sub SaveAs ( _
filename As Object, _
fileFormat As Object, _
password As Object, _
writeResPassword As Object, _
readOnlyRecommended As Object, _
createBackup As Object, _
accessMode As XlSaveAsAccessMode, _
conflictResolution As Object, _
addToMru As Object, _
textCodepage As Object, _
textVisualLayout As Object, _
local As Object _
)
public void SaveAs(
Object filename,
Object fileFormat,
Object password,
Object writeResPassword,
Object readOnlyRecommended,
Object createBackup,
XlSaveAsAccessMode accessMode,
Object conflictResolution,
Object addToMru,
Object textCodepage,
Object textVisualLayout,
Object local
)
Параметры
- filename
Тип: System.Object
Имя сохраняемого файла.Можно включить полный путь; если этого не сделать, Microsoft Office Excel сохранит файл в текущей папке.
- fileFormat
Тип: System.Object
Одно из значений XlFileFormat, указывающих формат файла для использования при сохранении файла.Для существующего файла используемым по умолчанию форматом является последний заданный для этого файла формат, для нового файла — формат используемой версии Excel.
- password
Тип: System.Object
Строка, для которой учитывается регистр, (длиной не более 15 символов) определяющая защитный пароль, который будет назначен файлу.
- writeResPassword
Тип: System.Object
Пароль защиты от записи для данного файла.Если файл сохранен с паролем и при его открытии пароль не введен, этот файл открывается только для чтения.
- readOnlyRecommended
Тип: System.Object
Значение true, чтобы при открытии файла выводилось сообщение с рекомендацией открыть его только для чтения.
- createBackup
Тип: System.Object
Значение true для создания файла резервной копии.
- accessMode
Тип: Microsoft.Office.Interop.Excel.XlSaveAsAccessMode
Одно из значений XlSaveAsAccessMode.
- conflictResolution
Тип: System.Object
Одно из значений XlSaveConflictResolution.
- addToMru
Тип: System.Object
Значение true, чтобы добавить данную книгу в список недавно использовавшихся файлов.Значение по умолчанию — false.
- textCodepage
Тип: System.Object
Не используется в Excel на английском (США) языке.
- textVisualLayout
Тип: System.Object
Не используется в Excel на английском (США) языке.
- local
Тип: System.Object
Значение true — сохранение файлов с языковыми настройками Excel (включая параметры панели управления).Значение false (по умолчанию) — сохранение файлов с языковыми настройками VBA.
Заметки
Visual Studio не поддерживает сохранение книги в виде общей книги.
Необязательные параметры
Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.
Примеры
В следующем примере путем проверки значений свойства FileFormat программный код определяет, является ли книга обычной книгой. Если книга является обычной рабочей книгой, в данном примере вызывается метод SaveAs для ее сохранения в виде электронной таблицы XML с именем XMLCopy.xlsx в папке, заданной свойством Path.
В этом примере демонстрируется настройка уровня документа.
Private Sub WorkbookSaveAs()
If Me.FileFormat = Excel.XlFileFormat.xlWorkbookNormal Then
Me.SaveAs(Me.Path & "\XMLCopy.xml", _
Excel.XlFileFormat.xlXMLSpreadsheet, _
AccessMode:=Excel.XlSaveAsAccessMode.xlNoChange)
End If
End Sub
private void WorkbookSaveAs()
{
if (this.FileFormat == Excel.XlFileFormat.xlWorkbookNormal)
{
this.SaveAs(this.Path + @"\XMLCopy.xml",
Excel.XlFileFormat.xlXMLSpreadsheet,
false, false, Excel.XlSaveAsAccessMode.xlNoChange);
}
}
Безопасность платформы .NET Framework
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.