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.

WindowsRuntimeStreamExtensions Class

.NET Framework 4.5

Contains extension methods for converting between streams in the Windows Runtime and managed streams in the .NET for Windows Store apps.

System.Object
  System.IO.WindowsRuntimeStreamExtensions

Namespace:  System.IO
Assembly:  System.Runtime.WindowsRuntime (in System.Runtime.WindowsRuntime.dll)

public static class WindowsRuntimeStreamExtensions

The WindowsRuntimeStreamExtensions type exposes the following members.

  NameDescription
Public methodStatic memberSupported in .NET for Windows Store appsAsInputStreamConverts a managed stream in the .NET for Windows Store apps to an input stream in the Windows Runtime.
Public methodStatic memberSupported in .NET for Windows Store appsAsOutputStreamConverts a managed stream in the .NET for Windows Store apps to an output stream in the Windows Runtime.
Public methodStatic memberAsRandomAccessStreamConverts the specified stream to a random access stream.
Public methodStatic memberSupported in .NET for Windows Store appsAsStream(IRandomAccessStream)Converts a random access stream in the Windows Runtime to a managed stream in the .NET for Windows Store apps.
Public methodStatic memberSupported in .NET for Windows Store appsAsStream(IRandomAccessStream, Int32)Converts a random access stream in the Windows Runtime to a managed stream in the .NET for Windows Store apps using the specified buffer size.
Public methodStatic memberSupported in .NET for Windows Store appsAsStreamForRead(IInputStream)Converts an input stream in the Windows Runtime to a managed stream in the .NET for Windows Store apps.
Public methodStatic memberSupported in .NET for Windows Store appsAsStreamForRead(IInputStream, Int32)Converts an input stream in the Windows Runtime to a managed stream in the .NET for Windows Store apps using the specified buffer size.
Public methodStatic memberSupported in .NET for Windows Store appsAsStreamForWrite(IOutputStream)Converts an output stream in the Windows Runtime to a managed stream in the .NET for Windows Store apps.
Public methodStatic memberSupported in .NET for Windows Store appsAsStreamForWrite(IOutputStream, Int32)Converts an output stream in the Windows Runtime to a managed stream in the .NET for Windows Store apps using the specified buffer size.
Top

These extension methods are available only when you develop Windows Store apps. The methods provide convenient ways of working with streams in Windows Store apps. You do not create an instance of the WindowsRuntimeStreamExtensions class; instead, you use these methods from instances of the IInputStream and IOutputStream interfaces and the Stream class.

The WindowsRuntimeStreamExtensions class contains two methods for converting a managed Stream object to a stream in the Windows Runtime:

The WindowsRuntimeStreamExtensions class contains three overloaded methods for converting a stream in the Windows Runtime to a Stream object:

Starting with the .NET Framework 4.5.1, the WindowsRuntimeStreamExtensions class contains a method for converting a stream to a Windows Runtime RandomAccessStream:

The following example shows how to use the AsStreamForWrite and AsStreamForRead methods to convert a managed stream to and from a stream in the Windows Runtime.

using System;
using System.IO;
using Windows.Storage;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;

namespace ExampleApplication
{
    public sealed partial class BlankPage : Page
    {
        public BlankPage()
        {
            this.InitializeComponent();
        }

        private async void CreateButton_Click(object sender, RoutedEventArgs e)
        {
            StorageFile newFile = await ApplicationData.Current.LocalFolder.CreateFileAsync("testfile.txt");
            var streamNewFile = await newFile.OpenAsync(FileAccessMode.ReadWrite);

            using (var outputNewFile = streamNewFile.GetOutputStreamAt(0))
            {
                using (StreamWriter writer = new StreamWriter(outputNewFile.AsStreamForWrite()))
                {
                    await writer.WriteLineAsync("content for new file");
                    await writer.WriteLineAsync(UserText.Text);
                }
            }
        }

        private async void VerifyButton_Click(object sender, RoutedEventArgs e)
        {
            StorageFile openedFile = await ApplicationData.Current.LocalFolder.GetFileAsync("testfile.txt");
            var streamOpenedFile = await openedFile.OpenAsync(FileAccessMode.Read);

            using (var inputOpenedFile = streamOpenedFile.GetInputStreamAt(0))
            {
                using (StreamReader reader = new StreamReader(inputOpenedFile.AsStreamForRead()))
                {
                    Results.Text = await reader.ReadToEndAsync();
                }
            }
        }
    }
}

Here's the XAML code that is associated with the previous example.

<Page
    x:Class="ExampleApplication.BlankPage"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:ExampleApplication"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    mc:Ignorable="d">

    <StackPanel Background="{StaticResource ApplicationPageBackgroundBrush}" VerticalAlignment="Center" HorizontalAlignment="Center">
        <TextBlock Text="Provide text to write to file:"></TextBlock>
        <TextBox Name="UserText" Width="400"></TextBox>
        <Button Name="CreateButton" Content="Create File" Click="CreateButton_Click"></Button>
        <Button Name="VerifyButton" Content="Verify Contents" Click="VerifyButton_Click"></Button>
        <TextBlock Name="Results"></TextBlock>
    </StackPanel>
</Page>

.NET Framework

Supported in: 4.5.3

.NET for Windows Store apps

Supported in: Windows 8

Supported in: Windows Phone Silverlight 8

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2014 Microsoft