以程式設計方式儲存文件

發行項
02/21/2024

儲存 Microsoft Office Word 文件的方式有很多種。您可以儲存文件而不變更文件名稱，也可以使用新名稱儲存文件。

適用對象：本主題資訊適用於文件層級的專案和 Word 的 VSTO 增益集專案。如需詳細資訊，請參閱依 Office 應用程式和專案類型提供的功能。

儲存文件而不變更名稱

若要儲存與文件層級自訂相關聯的文件

請呼叫 Save 類別的 Document 方法。若要使用此程式碼範例，請從專案的 ThisDocument 類別中執行它。
- C#
- VB
```
this.Save();
```
```
Me.Save()
```

若要儲存使用中的文件

為使用中的文件呼叫 Save 方法。若要使用這個程式碼範例，請從專案的 ThisDocument 或 ThisAddIn 類別中執行它。
- C#
- VB
```
this.Application.ActiveDocument.Save();
```
```
Me.Application.ActiveDocument.Save()
```
如果您不確定您要儲存的文件是否為使用中文件，您可以依其名稱加以參考。

若要儲存依名稱指定的文件

使用文件名稱做為 Documents 集合的引數。若要使用這個程式碼範例，請從專案的 ThisDocument 或 ThisAddIn 類別中執行它。
- C#
- VB
```
this.Application.Documents[@"C:\Test\NewDocument.docx"].Save();
```
```
Me.Application.Documents("C:\Test\NewDocument.docx").Save()
```

以新名稱儲存文件

使用 SaveAs 方法以新名稱儲存文件。您可以在文件層級 Word 專案中使用 Document 主項目的此方法，或在任何 Word 專案中使用原生 Document 物件的此方法。此方法要求您指定新檔案名稱，但其他引數是選擇性的。

注意

如果在 ThisDocument 的 DocumentBeforeSave 事件處理常式內顯示 另存新檔 對話方塊並將 Cancel 參數設為 false，應用程式可能會意外結束。如果將 Cancel 參數設為 true，則會出現錯誤訊息，指示自動儲存已停用。

若要以新名稱儲存與文件層級自訂相關聯的文件

使用完整路徑和檔案名稱呼叫專案中 ThisDocument 類別的 SaveAs 方法。如果該資料夾中已有同名的檔案，即會以無訊息方式覆寫。若要使用這個程式碼範例，請從 ThisDocument 類別執行程式碼。

注意

如果目標目錄不存在，或儲存檔案時出現其他問題，SaveAs 會擲回例外狀況。在 SaveAs 方法周圍或呼叫方法內部使用 try...catch 區塊是一種很好的做法。
- C#
- VB
```
object fileName = @"C:\Test\NewDocument.docx"; 

this.SaveAs(ref fileName,
    ref missing, ref missing, ref missing, ref missing, ref missing,
    ref missing, ref missing, ref missing, ref missing, ref missing,
    ref missing, ref missing, ref missing, ref missing, ref missing);
```
```
Me.SaveAs("C:\Test\NewDocument.docx")
```

若要以新名稱儲存原生文件

使用完整路徑和檔案名稱，呼叫您要儲存之 Document 的 SaveAs 方法。如果該資料夾中已有同名的檔案，即會以無訊息方式覆寫。

下列程式碼範例會以新名稱儲存使用中文件。若要使用這個程式碼範例，請從專案的 ThisDocument 或 ThisAddIn 類別中執行它。

注意

如果目標目錄不存在，或儲存檔案時出現其他問題，SaveAs 會擲回例外狀況。在 SaveAs 方法周圍或呼叫方法內部使用 try...catch 區塊是一種很好的做法。
- C#
- VB
```
object fileName = @"C:\Test\NewDocument.docx";

this.Application.ActiveDocument.SaveAs(ref fileName,
    ref missing, ref missing, ref missing, ref missing, ref missing,
    ref missing, ref missing, ref missing, ref missing, ref missing,
    ref missing, ref missing, ref missing, ref missing, ref missing);
```
```
Me.Application.ActiveDocument.SaveAs("C:\Test\NewDocument.docx")
```

編譯程式碼

這個程式碼範例需要下列項目：

若要依名稱儲存文件，名為 NewDocument.doc 的文件必須存在於磁碟機 C 上名為 Test 的目錄中。
若要以新名稱儲存文件，名為 Test 的目錄必須存在於磁碟機 C 上。