I​Output​Stream I​Output​Stream I​Output​Stream Interface

Definition

Represents a sequential stream of bytes to be written.

public : interface IOutputStreampublic interface IOutputStreamPublic Interface IOutputStream
Inheritance
IClosableIDisposableIDisposable
IOutputStreamIOutputStreamIOutputStream
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Inherited Members

Inherited methods

Methods

FlushAsync() FlushAsync() FlushAsync()

Flushes data asynchronously in a sequential stream.

public : IAsyncOperation<PlatForm::Boolean> FlushAsync()public IAsyncOperation<bool> FlushAsync()Public Function FlushAsync() As IAsyncOperation( Of bool )
Returns
IAsyncOperation<PlatForm::Boolean> IAsyncOperation<bool> IAsyncOperation<bool>

The stream flush operation.

Attributes

Remarks

The FlushAsync method may produce latencies and does not always guarantee durable and coherent storage of data. It's generally recommended to avoid this method if possible.

WriteAsync(IBuffer) WriteAsync(IBuffer) WriteAsync(IBuffer)

Writes data asynchronously in a sequential stream.

public : IAsyncOperationWithProgress<unsigned short, unsigned short> WriteAsync(IBuffer buffer)public IAsyncOperationWithProgress<uint, uint> WriteAsync(IBuffer buffer)Public Function WriteAsync(buffer As IBuffer) As IAsyncOperationWithProgress( Of uint, uint )
Parameters
buffer
IBuffer IBuffer IBuffer

A buffer that contains the data to be written.

Returns
IAsyncOperationWithProgress<unsigned short, unsigned short> IAsyncOperationWithProgress<uint, uint> IAsyncOperationWithProgress<uint, uint>

The byte writer operation.

Attributes

Remarks

Some stream implementations support queuing of write operations. In this case, the asynchronous execution of the WriteAsync method does not complete until the FlushAsync method has completed. For the buffer parameter, you don't have to implement the IBuffer interface. Instead, you can create an instance of the Buffer class or create a buffer by using methods in the CryptographicBuffer class.

Also consider writing a buffer into an IOutputStream by using the WriteBuffer method of the DataWriter class.