WindowsRuntimeStorageExtensions クラス


Windows ストア アプリ開発時の Windows ランタイム内の IStorageFile インターフェイスおよび IStorageFolder インターフェイス用の拡張メソッドを格納します。Contains extension methods for the IStorageFile and IStorageFolder interfaces in the Windows Runtime when developing Windows Store apps.

public ref class WindowsRuntimeStorageExtensions abstract sealed
public static class WindowsRuntimeStorageExtensions
public static class WindowsRuntimeStorageExtensions
type WindowsRuntimeStorageExtensions = class
type WindowsRuntimeStorageExtensions = class
Public Module WindowsRuntimeStorageExtensions

次の例は、Windows ストアアプリでアプリケーションデータのファイルをとして開き、クラスのインスタンスを使用してそのファイルに書き込む方法を示して Stream StreamWriter います。The following example shows how to open a file in the application data as a Stream in a Windows Store app, and write to it by using an instance of the StreamWriter class. 次に、クラスのインスタンスを使用して、ファイルの内容を読み取り StreamReader ます。It then reads the contents for the file by using an instance of the StreamReader class.

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

        private async void CreateButton_Click(object sender, RoutedEventArgs e)
            using (StreamWriter writer =
                new StreamWriter(await ApplicationData.Current.LocalFolder.OpenStreamForWriteAsync(
                "testfile.txt",  CreationCollisionOption.OpenIfExists)))
                await writer.WriteLineAsync("new entry");
                await writer.WriteLineAsync(UserText.Text);

        private async void VerifyButton_Click(object sender, RoutedEventArgs e)
            StorageFile openedFile = await ApplicationData.Current.LocalFolder.GetFileAsync("testfile.txt");
            using (StreamReader reader = new StreamReader(await openedFile.OpenStreamForReadAsync()))
                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)
        Using writer As StreamWriter =
               New StreamWriter(Await ApplicationData.Current.LocalFolder.OpenStreamForWriteAsync(
               "testfile.txt", CreationCollisionOption.OpenIfExists))
            Await writer.WriteLineAsync("new entry")
            Await writer.WriteLineAsync(UserText.Text)
        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")
        Using reader As StreamReader = New StreamReader(Await openedFile.OpenStreamForReadAsync())
            Results.Text = Await reader.ReadToEndAsync()
        End Using
    End Sub
End Class

次の例は、前の例に関連付けられている XAML コードを示しています。The next example shows the XAML code that is associated with the previous example.


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


これらの拡張メソッドは、Windows ストアアプリを開発する場合にのみ使用できます。These extension methods are available only when you develop Windows Store apps. これらのメソッドは、Windows ストアアプリで読み取りまたは書き込みを行うためにファイルを開く便利な方法を提供します。The methods provide convenient ways of opening files for reading or writing in Windows Store apps. クラスのインスタンスを作成するのでは WindowsRuntimeStorageExtensions なく、インターフェイスとインターフェイスのインスタンスからこれらのメソッドを使用し IStorageFile IStorageFolder ます。You do not create an instance of the WindowsRuntimeStorageExtensions class; instead, you use these methods from instances of the IStorageFile and IStorageFolder interfaces.

クラスには、 WindowsRuntimeStorageExtensions IStorageFile 読み取りまたは書き込みのためにを拡張する2つのメソッドが含まれています。The WindowsRuntimeStorageExtensions class contains two methods that extend IStorageFile for reading or writing:

WindowsRuntimeStorageExtensions クラスには、 IStorageFolder 読み取りと書き込みのためにを拡張する2つのメソッドが含まれています。The WindowsRuntimeStorageExtensions class contains two methods that extend IStorageFolder for reading and writing:


CreateSafeFileHandle(IStorageFile, FileAccess, FileShare, FileOptions)

現在のストレージ ファイル インスタンスのセーフ ファイル ハンドルを作成します。Creates a safe file handle for a the current storage file instance.

CreateSafeFileHandle(IStorageFolder, String, FileMode)

現在のストレージ フォルダー インスタンス内にあるファイルのセーフ ファイル ハンドルを作成します。Creates a safe file handle for a file that is in the current storage folder instance.

CreateSafeFileHandle(IStorageFolder, String, FileMode, FileAccess, FileShare, FileOptions)

現在のストレージ フォルダー インスタンス内にあるファイルのセーフ ファイル ハンドルを作成します。Creates a safe file handle for a file that is in the current storage folder instance.


指定したファイルから読み取るストリームを取得します。Retrieves a stream for reading from a specified file.

OpenStreamForReadAsync(IStorageFolder, String)

指定された親フォルダーのファイルから読み取るストリームを取得します。Retrieves a stream for reading from a file in the specified parent folder.


指定したファイルへ書き込むストリームを取得します。Retrieves a stream for writing to a specified file.

OpenStreamForWriteAsync(IStorageFolder, String, CreationCollisionOption)

指定された親フォルダーのファイルへ書き込むストリームを取得します。Retrieves a stream for writing to a file in the specified parent folder.