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

Applies to Windows and Windows Phone

Writes text to the file at the specified path or URI using the specified character encoding.

Syntax


Windows.Storage.PathIO.writeTextAsync(absolutePath, contents, encoding).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.

encoding

Type: UnicodeEncoding

The character encoding of the file.

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 load file resources and How to reference content.

This method attempts to automatically detect the encoding of a file based on the presence of byte order marks. If an encoding cannot be detected, the encoding specified by the caller is used.

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)

 

 

Show:
© 2014 Microsoft