Share via

_Document.SaveAs Method 

  • Article

Saves the specified document with a new name or format. Some of the arguments for this method correspond to the options in the Save As****dialog box (File menu).

Namespace: Microsoft.Office.Interop.Word
Assembly: Microsoft.Office.Interop.Word (in microsoft.office.interop.word.dll)

Usage

Dim FileName As Object
Dim FileFormat As Object
Dim LockComments As Object
Dim Password As Object
Dim AddToRecentFiles As Object
Dim WritePassword As Object
Dim ReadOnlyRecommended As Object
Dim EmbedTrueTypeFonts As Object
Dim SaveNativePictureFormat As Object
Dim SaveFormsData As Object
Dim SaveAsAOCELetter As Object
Dim Encoding As Object
Dim InsertLineBreaks As Object
Dim AllowSubstitutions As Object
Dim LineEnding As Object
Dim AddBiDiMarks As Object
Dim _Document1 As _Document
_Document1.SaveAs(FileName, FileFormat, LockComments, Password, AddToRecentFiles, WritePassword, ReadOnlyRecommended, EmbedTrueTypeFonts, SaveNativePictureFormat, SaveFormsData, SaveAsAOCELetter, Encoding, InsertLineBreaks, AllowSubstitutions, LineEnding, AddBiDiMarks)

Syntax

Sub SaveAs( _
    <InAttribute()> Optional ByRef FileName As Object, _
    <InAttribute()> Optional ByRef FileFormat As Object, _
    <InAttribute()> Optional ByRef LockComments As Object, _
    <InAttribute()> Optional ByRef Password As Object, _
    <InAttribute()> Optional ByRef AddToRecentFiles As Object, _
    <InAttribute()> Optional ByRef WritePassword As Object, _
    <InAttribute()> Optional ByRef ReadOnlyRecommended As Object, _
    <InAttribute()> Optional ByRef EmbedTrueTypeFonts As Object, _
    <InAttribute()> Optional ByRef SaveNativePictureFormat As Object, _
    <InAttribute()> Optional ByRef SaveFormsData As Object, _
    <InAttribute()> Optional ByRef SaveAsAOCELetter As Object, _
    <InAttribute()> Optional ByRef Encoding As Object, _
    <InAttribute()> Optional ByRef InsertLineBreaks As Object, _
    <InAttribute()> Optional ByRef AllowSubstitutions As Object, _
    <InAttribute()> Optional ByRef LineEnding As Object, _
    <InAttribute()> Optional ByRef AddBiDiMarks As Object _
)

void SaveAs(
    [In, Optional] ref object FileName, 
    [In, Optional] ref object FileFormat, 
    [In, Optional] ref object LockComments, 
    [In, Optional] ref object Password, 
    [In, Optional] ref object AddToRecentFiles, 
    [In, Optional] ref object WritePassword, 
    [In, Optional] ref object ReadOnlyRecommended, 
    [In, Optional] ref object EmbedTrueTypeFonts, 
    [In, Optional] ref object SaveNativePictureFormat, 
    [In, Optional] ref object SaveFormsData, 
    [In, Optional] ref object SaveAsAOCELetter, 
    [In, Optional] ref object Encoding, 
    [In, Optional] ref object InsertLineBreaks, 
    [In, Optional] ref object AllowSubstitutions, 
    [In, Optional] ref object LineEnding, 
    [In, Optional] ref object AddBiDiMarks
);

public: Void SaveAs(
    &Object^ FileName, 
    &Object^ FileFormat, 
    &Object^ LockComments, 
    &Object^ Password, 
    &Object^ AddToRecentFiles, 
    &Object^ WritePassword, 
    &Object^ ReadOnlyRecommended, 
    &Object^ EmbedTrueTypeFonts, 
    &Object^ SaveNativePictureFormat, 
    &Object^ SaveFormsData, 
    &Object^ SaveAsAOCELetter, 
    &Object^ Encoding, 
    &Object^ InsertLineBreaks, 
    &Object^ AllowSubstitutions, 
    &Object^ LineEnding, 
    &Object^ AddBiDiMarks
);

public void SaveAs(
    /*in*/System.Object FileName, 
    /*in*/System.Object FileFormat, 
    /*in*/System.Object LockComments, 
    /*in*/System.Object Password, 
    /*in*/System.Object AddToRecentFiles, 
    /*in*/System.Object WritePassword, 
    /*in*/System.Object ReadOnlyRecommended, 
    /*in*/System.Object EmbedTrueTypeFonts, 
    /*in*/System.Object SaveNativePictureFormat, 
    /*in*/System.Object SaveFormsData, 
    /*in*/System.Object SaveAsAOCELetter, 
    /*in*/System.Object Encoding, 
    /*in*/System.Object InsertLineBreaks, 
    /*in*/System.Object AllowSubstitutions, 
    /*in*/System.Object LineEnding, 
    /*in*/System.Object AddBiDiMarks
);

function SaveAs(
     FileName : Object, 
     FileFormat : Object, 
     LockComments : Object, 
     Password : Object, 
     AddToRecentFiles : Object, 
     WritePassword : Object, 
     ReadOnlyRecommended : Object, 
     EmbedTrueTypeFonts : Object, 
     SaveNativePictureFormat : Object, 
     SaveFormsData : Object, 
     SaveAsAOCELetter : Object, 
     Encoding : Object, 
     InsertLineBreaks : Object, 
     AllowSubstitutions : Object, 
     LineEnding : Object, 
     AddBiDiMarks : Object
);

Parameters

  • FileName
    Optional Object. The name for the document. The default is the current folder and file name. If the document has never been saved, the default name is used (for example, Doc1.doc). If a document with the specified file name already exists, the document is overwritten without the user being prompted first.
  • FileFormat
    Optional Object. The format in which the document is saved. Can be any WdSaveFormat constant. To save a document in another format, specify the appropriate value for the SaveFormat property of the FileConverter object.
  • LockComments
    Optional Object. True to lock the document for comments. The default is False.
  • Password
    Optional Object. A password string for opening the document. (See Remarks below.)
  • AddToRecentFiles
    Optional Object. True to add the document to the list of recently used files on the File menu. The default is True.
  • WritePassword
    Optional Object. A password string for saving changes to the document. (See Remarks below.)
  • ReadOnlyRecommended
    Optional Object. True to have Microsoft Word suggest read-only status whenever the document is opened. The default is False.
  • EmbedTrueTypeFonts
    Optional Object. True to save TrueType fonts with the document. If omitted, the EmbedTrueTypeFonts argument assumes the value of the EmbedTrueTypeFonts property.
  • SaveNativePictureFormat
    Optional Object. If graphics were imported from another platform (for example, Macintosh), True to save only the Windows version of the imported graphics.
  • SaveFormsData
    Optional Object. True to save the data entered by a user in a form as a data record.
  • SaveAsAOCELetter
    Optional Object. If the document has an attached mailer, True to save the document as an AOCE letter (the mailer is saved).
  • Encoding
    Optional Microsoft.Office.Core.MsoEncoding. The code page, or character set, to use for documents saved as encoded text files. The default is the system code page.
  • InsertLineBreaks
    Optional Object. If the document is saved as a text file, True to insert line breaks at the end of each line of text.
  • AllowSubstitutions
    Optional Object. If the document is saved as a text file, True allows Word to replace some symbols with text that looks similar. For example, displaying the copyright symbol as (c). The default is False.
  • LineEnding
    Optional Object. The way Word marks the line and paragraph breaks in documents saved as text files. Can be any WdLineEndingType constant.
  • AddBiDiMarks
    Optional Object. True adds control characters to the output file to preserve bi-directional layout of the text in the original document.

Remarks

Avoid using hard-coded passwords in your applications. If a password is required in a procedure, request the password from the user, store it in a variable, and then use the variable in your code.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows XP Home Edition, Windows XP Professional, Windows Server 2003, and Windows 2000

Target Platforms

See Also

Reference

_Document Interface
Microsoft.Office.Interop.Word Namespace

Other Resources

_Document Members