WorksheetBase.SaveAs Method

Article
06/14/2013

Saves changes to the worksheet in a different file.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntax

'Declaration
Public Sub SaveAs ( _
    filename As String, _
    fileFormat As Object, _
    password As Object, _
    writeResPassword As Object, _
    readOnlyRecommended As Object, _
    createBackup As Object, _
    addToMru As Object, _
    textCodepage As Object, _
    textVisualLayout As Object, _
    local As Object _
)

public void SaveAs(
    string filename,
    Object fileFormat,
    Object password,
    Object writeResPassword,
    Object readOnlyRecommended,
    Object createBackup,
    Object addToMru,
    Object textCodepage,
    Object textVisualLayout,
    Object local
)

Parameters

filename
Type: System.String

The name of the file to be saved. You can include a full path; if you do not, Microsoft Office Excel saves the file in the current folder.

fileFormat
Type: System.Object

The file format to use when you save the file. For a list of valid choices, see the FileFormat property. For an existing file, the default format is the last file format specified; for a new file, the default is the format of the version of Excel being used.

password
Type: System.Object

A case-sensitive string (no more than 15 characters) that indicates the protection password to be given to the file.

writeResPassword
Type: System.Object

The write-reservation password for this file. If a file is saved with the password and the password is not supplied when the file is opened, the file is opened as read-only.

readOnlyRecommended
Type: System.Object

true to display a message when the file is opened, recommending that the file be opened as read-only.

createBackup
Type: System.Object

true to create a backup file.

addToMru
Type: System.Object

true to add this workbook to the list of recently used files. The default value is false.

textCodepage
Type: System.Object

Not used in U.S. English Excel.

textVisualLayout
Type: System.Object

Not used in U.S. English Excel.

local
Type: System.Object

true saves files against the language of Excel (including control panel settings); false (default) saves files against the language of Visual Basic for Applications (VBA).

Remarks

Optional Parameters

For information on optional parameters, see Optional Parameters in Office Solutions.

Examples

The following code example uses the SaveAs method to save a new copy of the current worksheet.

This example is for a document-level customization.

Private Sub SaveWorksheetCopy()
    Me.SaveAs(Me.Name + ".copy.xlsx")
End Sub

private void SaveWorksheetCopy()
{
    this.SaveAs(this.Name + ".copy.xlsx");
}

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Share via