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(默认值),则按照 Visual Basic for Applications (VBA) 的语言保存文件。
备注
Visual Studio 不支持将工作簿保存为共享工作簿。
可选参数
有关可选参数的信息,请参见Office 解决方案中的可选参数。
示例
下面的代码示例检查 FileFormat 属性的值,以确定工作簿是否为普通工作簿。 如果工作簿是普通工作簿,则该示例调用 SaveAs 方法,将该工作簿重新保存为一个名为 XMLCopy.xlsx 的 XML 电子表格,放在 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 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。