Windows Dev Center

Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

PathIO.WriteLinesAsync(String, IIterable(String), UnicodeEncoding) | writeLinesAsync(String, IIterable(String), UnicodeEncoding) method

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

Syntax


public static IAsyncAction WriteLinesAsync(
  string absolutePath, 
  IEnumerable<string> lines, 
  UnicodeEncoding encoding
)

Parameters

absolutePath

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

The path of the file that the lines are appended to.

lines

Type: IIterable<String> [JavaScript/C++] | System.Collections.Generic.IEnumerable<String> [.NET]

The list of text strings to append as lines.

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 (Windows 10 device family)

Device family

Universal

API contract

Windows.Foundation.UniversalApiContract, introduced version 1.0

Namespace

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

Metadata

Windows.Foundation.UniversalApiContract.winmd

Requirements (Windows 8.x and Windows Phone 8.x)

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
WriteLinesAsync(String, IIterable(String))

 

 

Show:
© 2015 Microsoft