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
U.S. English Excel 不適用。
- textVisualLayout
型別:System.Object
U.S. English Excel 不適用。
- local
型別:System.Object
true 表示會根據 Excel 所使用的語言 (包括控制台設定) 儲存檔案。false (預設) 根據 Visual Basic for Application (VBA) 的語言儲存檔案。
備註
Visual Studio 不支援將活頁簿儲存成共用的活頁簿。
選擇性參數
如需選擇性參數的詳細資訊,請參閱Office 方案中的選擇性參數。
範例
下列程式碼範例檢查 FileFormat 屬性的值,判斷活頁簿是否為正常的活頁簿。 如果活頁簿為正常的活頁簿,則此範例會呼叫 SaveAs 方法,將活頁簿重新儲存成名為 XMLCopy.xls 的 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, missing, missing,
false, false, Excel.XlSaveAsAccessMode.xlNoChange,
missing, missing, missing, missing, missing);
}
}
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。