DocumentBase.SaveAs2 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
使用新名稱或新格式儲存文件。 此方法的部分引數對應到 [另存新檔] 對話方塊中的選項。
public void SaveAs2 (ref object fileName, ref object fileFormat, ref object lockComments, ref object password, ref object addToRecentFiles, ref object writePassword, ref object readOnlyRecommended, ref object embedTrueTypeFonts, ref object saveNativePictureFormat, ref object saveFormsData, ref object saveAsAOCELetter, ref object encoding, ref object insertLineBreaks, ref object allowSubstitutions, ref object lineEnding, ref object addBiDiMarks, ref object compatibilityMode);
member this.SaveAs2 : obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj -> unit
Public Sub SaveAs2 (Optional ByRef fileName As Object, Optional ByRef fileFormat As Object, Optional ByRef lockComments As Object, Optional ByRef password As Object, Optional ByRef addToRecentFiles As Object, Optional ByRef writePassword As Object, Optional ByRef readOnlyRecommended As Object, Optional ByRef embedTrueTypeFonts As Object, Optional ByRef saveNativePictureFormat As Object, Optional ByRef saveFormsData As Object, Optional ByRef saveAsAOCELetter As Object, Optional ByRef encoding As Object, Optional ByRef insertLineBreaks As Object, Optional ByRef allowSubstitutions As Object, Optional ByRef lineEnding As Object, Optional ByRef addBiDiMarks As Object, Optional ByRef compatibilityMode As Object)
參數
- fileName
- Object
文件的名稱。 預設為目前的資料夾和檔案名稱。 如果未曾儲存過文件,就會使用預設名稱 (例如 Doc1.doc)。 如果指定檔名的文件已存在,並不會先提示使用者,而是直接覆寫文件。
- fileFormat
- Object
儲存文件的格式。 可以是任何的 WdSaveFormat 值。 若要使用其他格式儲存文件,請指定適用於 SaveFormat 屬性的值。
- lockComments
- Object
true
表示鎖定文件的註解。 預設為 false
。
- password
- Object
開啟文件的密碼字串。 請參閱下方註解。
- addToRecentFiles
- Object
若為 true
,便會將文件新增至最近使用的檔案清單 (位於 [檔案] 功能表)。 預設為 true
。
- writePassword
- Object
將變更儲存至文件的密碼。 請參閱下方註解。
- readOnlyRecommended
- Object
true
表示每次開啟文件時,Microsoft Office Word 都會建議採取唯讀狀態。 預設為 false
。
- embedTrueTypeFonts
- Object
true
表示隨文件一併儲存 TrueType 字型。 如果省略,自 EmbedTrueTypeFonts
變數會假設 屬性的值 EmbedTrueTypeFonts 。
- saveNativePictureFormat
- Object
如果從其他平台 (例如 Macintosh) 匯入圖形,true
表示只儲存 Windows 版本的已匯入圖形。
- saveFormsData
- Object
true
表示將使用者輸入至表單的資料儲存為資料錄。
- saveAsAOCELetter
- Object
如果文件已附加寄件者,true
表示將文件儲存為 AOCE 信件 (已儲存寄件者)。
- encoding
- Object
MsoEncoding. 用來將文件儲存為已編碼文字檔的字碼頁或字元集。 預設為系統字碼頁。
- insertLineBreaks
- Object
如果將文件儲存為文字檔,true
表示在每一行文字末端插入斷行符號。
- allowSubstitutions
- Object
如果將文件儲存為文字檔,true
表示允許 Word 使用外觀相似的文字取代某些符號。 例如,使用 (c) 代表版權符號。 預設為 false
。
- lineEnding
- Object
在儲存為文字檔的文件中,Word 標示斷行符號和段落符號的方式。 可以是任何的 T:Microsoft.Office.Interop.Word.WdLineEndingType 值。
- addBiDiMarks
- Object
true 表示將控制字元加入至輸出檔,在原始文件中保留文字的雙向配置。
- compatibilityMode
- Object
其中Microsoft.Office.Interop.Word.WdCompatibilityMode
一個值,指定開啟檔時 Word 2013 和 Word 2010 使用的相容性模式。
例外狀況
這個屬性用在 Word 2007 專案。
範例
下列程式代碼範例會 <xref:Microsoft.Office.Tools.Word.DocumentBase.SaveAs%2A> 使用 方法來使用新的檔名 myfile.docx,以 RTF 格式儲存檔。 若要使用此範例,請從文件層級專案中的 ThisDocument
類別執行它。
private void DocumentSaveAs()
{
object FileName = "myfile.docx";
object FileFormat = Word.WdSaveFormat.wdFormatRTF;
object LockComments = false;
object AddToRecentFiles = true;
object ReadOnlyRecommended = false;
object EmbedTrueTypeFonts = false;
object SaveNativePictureFormat = true;
object SaveFormsData = true;
object SaveAsAOCELetter = false;
object Encoding = Office.MsoEncoding.msoEncodingUSASCII;
object InsertLineBreaks = false;
object AllowSubstitutions = false;
object LineEnding = Word.WdLineEndingType.wdCRLF;
object AddBiDiMarks = false;
if (this.SaveFormat == (int)Word.WdSaveFormat.wdFormatDocument)
{
this.SaveAs(ref FileName, ref FileFormat, ref LockComments,
ref missing, ref AddToRecentFiles, ref missing,
ref ReadOnlyRecommended, ref EmbedTrueTypeFonts,
ref SaveNativePictureFormat, ref SaveFormsData,
ref SaveAsAOCELetter, ref Encoding, ref InsertLineBreaks,
ref AllowSubstitutions, ref LineEnding, ref AddBiDiMarks);
}
}
Private Sub DocumentSaveAs()
Me.SaveAs(FileName:="myfile.docx", FileFormat:=Word.WdSaveFormat.wdFormatRTF, _
LockComments:=False, AddToRecentFiles:=True, ReadOnlyRecommended:=False, _
EmbedTrueTypeFonts:=False, SaveNativePictureFormat:=True, _
SaveFormsData:=True, SaveAsAOCELetter:=False, _
Encoding:=Office.MsoEncoding.msoEncodingUSASCII, _
InsertLineBreaks:=False, AllowSubstitutions:=False, _
LineEnding:=Word.WdLineEndingType.wdCRLF, _
AddBiDiMarks:=False)
End Sub
備註
避免在應用程式中使用硬式編碼密碼。 如果程式中需要密碼,請向使用者要求密碼、將密碼儲存在變數中,然後在您的程式代碼中使用變數。
注意
此方法會出現在以 .NET Framework 4 為目標的 Word 2007 專案中的 IntelliSense 中。 不過,此屬性不能用於 Word 2007 專案中。
選擇性參數
如需選擇性參數的資訊,請參閱 Office 方案中的選擇性參數。