ITextDocument.SaveAs Method

Reference

Definition

Namespace:: Microsoft.VisualStudio.Text

Assembly:: Microsoft.VisualStudio.Text.Data.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Overloads

SaveAs(String, Boolean)	Saves the contents of the TextBuffer to the given `filePath`. If the save operation is successful, FilePath is set to `filePath`, and IsDirty is set to `false`. If the save operation fails, FilePath and IsDirty remains unchanged.
SaveAs(String, Boolean, IContentType)	Saves the contents of the TextBuffer to the given `filePath`. If the save is successful, FilePath is set to `filePath`, and IsDirty is set to `false`. If the save fails, FilePath and IsDirty remains unchanged.
SaveAs(String, Boolean, Boolean)	Saves the contents of the TextBuffer to the given `filePath`. If the save operation is successful, FilePath is set to `filePath`, and IsDirty is set to `false`. If the save operation fails, FilePath and IsDirty remains unchanged.
SaveAs(String, Boolean, Boolean, IContentType)	Saves the contents of the TextBuffer to the given `filePath`. If the save is successful, FilePath is set to `filePath`, and IsDirty is set to `false`. If the save fails, FilePath and IsDirty remains unchanged.

SaveAs(String, Boolean)

Saves the contents of the TextBuffer to the given filePath. If the save operation is successful, FilePath is set to filePath, and IsDirty is set to false. If the save operation fails, FilePath and IsDirty remains unchanged.

public:
 void SaveAs(System::String ^ filePath, bool overwrite);

public:
 void SaveAs(Platform::String ^ filePath, bool overwrite);

void SaveAs(std::wstring const & filePath, bool overwrite);

public void SaveAs (string filePath, bool overwrite);

abstract member SaveAs : string * bool -> unit

Public Sub SaveAs (filePath As String, overwrite As Boolean)

Parameters

filePath: String

The name of the new file.

overwrite: Boolean

true if filePath should be overwritten if it exists, otherwise false.

Exceptions

ArgumentNullException

filePath is null.

IOException

An I/O error occurred (including an error caused by attempting to overwrite an existing file when overwrite is false).

UnauthorizedAccessException

An access error occurred during file save.

ObjectDisposedException

This object has been disposed.

InvalidOperationException

This object is in the middle of raising events.

Remarks

If the save operation is successful, FilePath is set to filePath, and IsDirty is set to false. If the save operation fails, FilePath and IsDirty remains unchanged.

Applies to

SaveAs(String, Boolean, IContentType)

Saves the contents of the TextBuffer to the given filePath. If the save is successful, FilePath is set to filePath, and IsDirty is set to false. If the save fails, FilePath and IsDirty remains unchanged.

public:
 void SaveAs(System::String ^ filePath, bool overwrite, Microsoft::VisualStudio::Utilities::IContentType ^ newContentType);

public:
 void SaveAs(Platform::String ^ filePath, bool overwrite, Microsoft::VisualStudio::Utilities::IContentType ^ newContentType);

void SaveAs(std::wstring const & filePath, bool overwrite, Microsoft::VisualStudio::Utilities::IContentType const & newContentType);

public void SaveAs (string filePath, bool overwrite, Microsoft.VisualStudio.Utilities.IContentType newContentType);

abstract member SaveAs : string * bool * Microsoft.VisualStudio.Utilities.IContentType -> unit

Public Sub SaveAs (filePath As String, overwrite As Boolean, newContentType As IContentType)

Parameters

filePath: String

The name of the new file.

overwrite: Boolean

true if filePath should be overwritten if it exists, otherwise false.

newContentType: IContentType

The new IContentType.

Exceptions

ArgumentNullException

filePath or newContentType is null.

IOException

An I/O error occurred (including an error caused by attempting to overwrite an existing file when overwrite is false).

UnauthorizedAccessException

An access error occurred during file save.

ObjectDisposedException

This object has been disposed.

InvalidOperationException

This object is in the middle of raising events.

Remarks

The order of events raised as a result of a successful file SaveAs operation is FileActionOccurred followed by ContentTypeChanged.

Applies to

SaveAs(String, Boolean, Boolean)

public:
 void SaveAs(System::String ^ filePath, bool overwrite, bool createFolder);

public:
 void SaveAs(Platform::String ^ filePath, bool overwrite, bool createFolder);

void SaveAs(std::wstring const & filePath, bool overwrite, bool createFolder);

public void SaveAs (string filePath, bool overwrite, bool createFolder);

abstract member SaveAs : string * bool * bool -> unit

Public Sub SaveAs (filePath As String, overwrite As Boolean, createFolder As Boolean)

Parameters

filePath: String

The name of the new file.

overwrite: Boolean

true if filePath should be overwritten if it exists, otherwise false.

createFolder: Boolean

true if the folder containing filePath should be created if it does not exist, otherwise false.

Exceptions

ArgumentNullException

filePath is null.

IOException

An I/O error occurred (including an error caused by attempting to overwrite an existing file when overwrite is false).

UnauthorizedAccessException

An access error occurred during file save.

ObjectDisposedException

This object has been disposed.

InvalidOperationException

This object is in the middle of raising events.

Remarks

If the save operation is successful, FilePath is set to filePath, and IsDirty is set to false. If the save operation fails, FilePath and IsDirty remains unchanged.

Applies to

SaveAs(String, Boolean, Boolean, IContentType)

public:
 void SaveAs(System::String ^ filePath, bool overwrite, bool createFolder, Microsoft::VisualStudio::Utilities::IContentType ^ newContentType);

public:
 void SaveAs(Platform::String ^ filePath, bool overwrite, bool createFolder, Microsoft::VisualStudio::Utilities::IContentType ^ newContentType);

void SaveAs(std::wstring const & filePath, bool overwrite, bool createFolder, Microsoft::VisualStudio::Utilities::IContentType const & newContentType);

public void SaveAs (string filePath, bool overwrite, bool createFolder, Microsoft.VisualStudio.Utilities.IContentType newContentType);

abstract member SaveAs : string * bool * bool * Microsoft.VisualStudio.Utilities.IContentType -> unit

Public Sub SaveAs (filePath As String, overwrite As Boolean, createFolder As Boolean, newContentType As IContentType)

Parameters

filePath: String

The name of the new file.

overwrite: Boolean

true if filePath should be overwritten if it exists, otherwise false.

createFolder: Boolean

true if the folder containing filePath should be created if it does not exist, otherwise false.

newContentType: IContentType

The new IContentType.

Exceptions

ArgumentNullException

filePath or newContentType is null.

IOException

An I/O error occurred (including an error caused by attempting to overwrite an existing file when overwrite is false).

UnauthorizedAccessException

An access error occurred during file save.

ObjectDisposedException

This object has been disposed.

InvalidOperationException

This object is in the middle of raising events.

Remarks

The order of events raised as a result of a successful file SaveAs operation is FileActionOccurred followed by ContentTypeChanged.

Applies to

ITextDocument.SaveAs Method

Definition

Overloads

SaveAs(String, Boolean)

Parameters

Exceptions

Remarks

Applies to

SaveAs(String, Boolean, IContentType)

Parameters

Exceptions

Remarks

Applies to

SaveAs(String, Boolean, Boolean)

Parameters

Exceptions

Remarks

Applies to

SaveAs(String, Boolean, Boolean, IContentType)

Parameters

Exceptions

Remarks

Applies to

Additional resources