PathIO.WriteTextAsync(String, String) | writeTextAsync(String, String) method

Applies to Windows and Windows Phone

Writes text to the file at the specified path or URI.

Syntax


Windows.Storage.PathIO.writeTextAsync(absolutePath, contents).done( /* Your success and error handlers */ );

Parameters

absolutePath

Type: String [JavaScript] | System.String [.NET] | Platform::String [C++]

The path of the file that the text is written to.

contents

Type: String [JavaScript] | System.String [.NET] | Platform::String [C++]

The text to write.

Return value

Type: IAsyncAction

No object or value is returned when this method completes.

Remarks

Note  To read or write to a file using a path or URIs, you must have permission to access the file's location.

You can specify an app URIs to read or write files in app-specific locations like your app data folder ("ms-appdata://"). To learn more about app URIs, see How to reference content.

Examples

This example shows you how to use writeTextAsync(absolutePath, contents) to write some arbitrary text to a file at the path in absoluteFilePath, like this:


Windows.Storage.FileIO.writeTextAsync(absoluteFilePath, "Swift as a shadow").then(function () {
    // Add code to do something after the text is written to the file
});

Although the writeTextAsync methods don't have a return value, you can still use then or done to declare a function and perform additional tasks after the text is written to the file, as the sample shows.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Namespace

Windows.Storage
Windows::Storage [C++]

Metadata

Windows.winmd

See also

PathIO
WriteTextAsync(String, String, UnicodeEncoding)

 

 

Show:
© 2014 Microsoft