Workbook.SaveAs Метод (2007 System)

Статья
11/16/2008

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

Сохраняет изменения в книге в другой файл.

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v9.0 (в Microsoft.Office.Tools.Excel.v9.0.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 _
)
'Применение
Dim instance As Workbook
Dim Filename As Object
Dim FileFormat As Object
Dim Password As Object
Dim WriteResPassword As Object
Dim ReadOnlyRecommended As Object
Dim CreateBackup As Object
Dim AccessMode As XlSaveAsAccessMode
Dim ConflictResolution As Object
Dim AddToMru As Object
Dim TextCodepage As Object
Dim TextVisualLayout As Object
Dim Local As Object

instance.SaveAs(Filename, FileFormat, _
    Password, WriteResPassword, ReadOnlyRecommended, _
    CreateBackup, AccessMode, ConflictResolution, _
    AddToMru, TextCodepage, TextVisualLayout, _
    Local)

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
Формат, в котором требуется сохранить файл. См. свойство FileFormat для получения списка допустимых вариантов. Для существующего файла используемым по умолчанию форматом является последний заданный для этого файла формат, для нового файла — формат используемой версии 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.

Заметки

Microsoft Visual Studio 2005 Tools for Office не поддерживает сохранение книги в виде общей книги.

Необязательные параметры

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

Примеры

В следующем примере путем проверки значений свойства FileFormat программный код определяет, является ли книга обычной книгой. Если книга является обычной рабочей книгой, в данном примере вызывается метод SaveAs для ее сохранения в виде электронной таблицы XML с именем XMLCopy.xls в папке, заданной в свойстве Path.

В этом примере демонстрируется настройка уровня документа.

Private Sub WorkbookSaveAs()
    If Me.FileFormat = Excel.XlFileFormat.xlWorkbookNormal Then
        Me.SaveAs(Me.Path & "\XMLCopy.xls", _
            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.xls",
            Excel.XlFileFormat.xlXMLSpreadsheet, missing, missing,
            false, false, Excel.XlSaveAsAccessMode.xlNoChange,
            missing, missing, missing, missing, missing);
    }
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

Workbook Класс

Workbook - члены

Microsoft.Office.Tools.Excel - пространство имен

Поделиться через