ITextDocument.SaveAs Method (String, Boolean, IContentType)

Saves the contents of the TextBuffer to the specified file path.

Namespace:  Microsoft.VisualStudio.Text
Assembly:  Microsoft.VisualStudio.Text.Data (in Microsoft.VisualStudio.Text.Data.dll)

void SaveAs(
	string filePath,
	bool overwrite,
	IContentType newContentType
)

Parameters

filePath
Type: String

The name of the new file.

overwrite
Type: Boolean

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

newContentType
Type: Microsoft.VisualStudio.Utilities.IContentType

The new IContentType.

ExceptionCondition
InvalidOperationException

This object is in the middle of raising events.

ArgumentNullException

filePath or newContentType is null.

UnauthorizedAccessException

An access error occurred during file save.

IOException

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

ObjectDisposedException

This object has been disposed.

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.

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

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft