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.

FileIO.WriteBufferAsync | writeBufferAsync method

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 (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

FileIO

 

 

Show:
© 2015 Microsoft