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.

FileIO.WriteBufferAsync | writeBufferAsync method

Applies to Windows and Windows Phone

Writes data from a buffer to the specified file.

Syntax


Windows.Storage.FileIO.writeBufferAsync(file, buffer).done( /* Your success and error handlers */ );

Parameters

file

Type: IStorageFile

The file that the buffer of data is written to.

buffer

Type: IBuffer

The buffer that contains the data to write.

Return value

Type: IAsyncAction

No object or value is returned when this method completes.

Examples

The File Access sample shows you how to use writeBufferAsync to write to a file.



if (file !== null) {
    // Create buffer
    var memoryStream = new Windows.Storage.Streams.InMemoryRandomAccessStream();
    var dataWriter = new Windows.Storage.Streams.DataWriter(memoryStream);
    dataWriter.writeString("Swift as a shadow");
    var buffer = dataWriter.detachBuffer();
    dataWriter.close();

    // Write buffer to file
    Windows.Storage.FileIO.writeBufferAsync(file, buffer).done(function () {
        // Perform additional tasks after file is written
    },
    // Handle errors with an error function
    function (error) {
        // Handle errors encountered during write
    });
}

In the example, file is a local variable that contains a storageFile that represents the file to write.

Although the writeBufferAsync methods don't have a return value, you can still perform additional tasks after the text is written to the file, as the example 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

FileIO

 

 

Show:
© 2014 Microsoft