WindowsRuntimeStreamExtensions クラス

リファレンス

定義

名前空間:: System.IO

アセンブリ:: System.Runtime.WindowsRuntime.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

Windows ランタイムのストリームと Windows ストアアプリ用 .NET のマネージドストリームとの間の変換を実行するための拡張メソッドが含まれます。

public ref class WindowsRuntimeStreamExtensions abstract sealed

public static class WindowsRuntimeStreamExtensions

[System.Security.SecurityCritical]
public static class WindowsRuntimeStreamExtensions

type WindowsRuntimeStreamExtensions = class

[<System.Security.SecurityCritical>]
type WindowsRuntimeStreamExtensions = class

Public Module WindowsRuntimeStreamExtensions

継承: Object
WindowsRuntimeStreamExtensions

属性: SecurityCriticalAttribute

例

次の例は、次のコードを使用する方法を示しています。AsStreamForWrite AsStreamForRead

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();
                }
            }
        }
    }
}

Imports System.IO
Imports Windows.Storage

NotInheritable Public Class BlankPage
    Inherits Page

    Private Async Sub CreateButton_Click(sender As Object, e As RoutedEventArgs)
        Dim newFile As StorageFile = Await ApplicationData.Current.LocalFolder.CreateFileAsync("testfile.txt")
        Dim streamNewFile = Await newFile.OpenAsync(FileAccessMode.ReadWrite)

        Using outputNewFile = streamNewFile.GetOutputStreamAt(0)
            Using writer As StreamWriter = New StreamWriter(outputNewFile.AsStreamForWrite())
                Await writer.WriteLineAsync("content for new file")
                Await writer.WriteLineAsync(UserText.Text)
            End Using
        End Using
    End Sub

    Private Async Sub VerifyButton_Click(sender As Object, e As RoutedEventArgs)
        Dim openedFile As StorageFile = Await ApplicationData.Current.LocalFolder.GetFileAsync("testfile.txt")
        Dim streamOpenedFile = Await openedFile.OpenAsync(FileAccessMode.Read)

        Using inputOpenedFile = streamOpenedFile.GetInputStreamAt(0)

            Using reader As StreamReader = New StreamReader(inputOpenedFile.AsStreamForRead())
                Results.Text = Await reader.ReadToEndAsync()
            End Using
        End Using
    End Sub
End Class

前の例に関連付けられている XAML コードを次に示します。

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

注釈

これらの拡張メソッドは、Windowsストアアプリを開発する場合にのみ使用できます。このメソッドは、Windows ストアアプリでストリームを操作する便利な方法を提供します。クラスのWindowsRuntimeStreamExtensionsインスタンスは作成しません。代わりに、インターフェイスとIOutputStreamクラスのインスタンスからこれらのメソッドをIInputStream Stream使用します。

このWindowsRuntimeStreamExtensionsクラスには、マネージド Stream オブジェクトをWindows ランタイムのストリームに変換するための 2 つのメソッドが含まれています。

このWindowsRuntimeStreamExtensionsクラスには、Windows ランタイム内のストリームをオブジェクトに変換するための 3 つのオーバーロードされたメソッドがStream含まれています。

.NET Framework 4.5.1 以降、クラスにはストリームWindowsRuntimeStreamExtensionsをWindows ランタイムRandomAccessStreamに変換するためのメソッドが含まれています。

AsRandomAccessStream(Stream)

メソッド

AsInputStream(Stream)	Windows ストアアプリ用 .NET のマネージドストリームを Windows ランタイムの入力ストリームに変換します。
AsOutputStream(Stream)	Windows ストアアプリ用 .NET のマネージドストリームを Windows ランタイムの出力ストリームに変換します。
AsRandomAccessStream(Stream)	特定のストリームをランダムアクセスストリームに変換します。
AsStream(IRandomAccessStream)	Windows ランタイムのランダムアクセスストリームを Windows ストアアプリ用 .NET のマネージドストリームに変換します。
AsStream(IRandomAccessStream, Int32)	指定のバッファーサイズを利用し、Windows ランタイムのランダムアクセスストリームを Windows ストアアプリ用 .NET のマネージドストリームに変換します。
AsStreamForRead(IInputStream)	Windows ランタイムの入力ストリームを Windows ストアアプリ用 .NET のマネージドストリームに変換します。
AsStreamForRead(IInputStream, Int32)	指定のバッファーサイズを利用し、Windows ランタイムの入力ストリームを Windows 8.x ストアアプリ用 .NET のマネージドストリームに変換します。
AsStreamForWrite(IOutputStream)	Windows ランタイムの出力ストリームを Windows 8.x ストアアプリ用 .NET のマネージドストリームに変換します。
AsStreamForWrite(IOutputStream, Int32)	指定のバッファーサイズを利用し、Windows ランタイムの出力ストリームを Windows ストアアプリ用 .NET のマネージドストリームに変換します。

適用対象

WindowsRuntimeStreamExtensions クラス

定義

例

注釈

メソッド

適用対象

その他のリソース