WindowsRuntimeStorageExtensions Класс

Определение

Пространство имен:

System.IO

Сборка:

System.Runtime.WindowsRuntime.dll

Содержит методы расширения для интерфейсов IStorageFile и IStorageFolder в среде выполнения Windows при разработке приложений для Магазина приложений Windows.

public ref class WindowsRuntimeStorageExtensions abstract sealed

public static class WindowsRuntimeStorageExtensions

type WindowsRuntimeStorageExtensions = class

Public Module WindowsRuntimeStorageExtensions

Наследование

Object

WindowsRuntimeStorageExtensions

Примеры

В следующем примере показано, как открыть файл в данных приложения как Stream в приложении Магазина Windows и выполнить запись в него с помощью экземпляра StreamWriter класса . Затем он считывает содержимое файла с помощью экземпляра StreamReader класса .

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)
        {
            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, связанный с предыдущим примером.

<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. Экземпляр класса не создается WindowsRuntimeStorageExtensions ; вместо этого используются эти методы из экземпляров IStorageFile интерфейсов и IStorageFolder .

Класс WindowsRuntimeStorageExtensions содержит два метода, которые расширяют возможности IStorageFile чтения или записи:

• OpenStreamForReadAsync(IStorageFile)
• OpenStreamForWriteAsync(IStorageFile)

Класс WindowsRuntimeStorageExtensions содержит два метода, которые расширяют IStorageFolder возможности чтения и записи:

• OpenStreamForReadAsync(IStorageFolder, String)
• OpenStreamForWriteAsync(IStorageFolder, String, CreationCollisionOption)

Методы

CreateSafeFileHandle(IStorageFile, FileAccess, FileShare, FileOptions)	Создает безопасный дескриптор файла для текущего экземпляра файла хранилища.
CreateSafeFileHandle(IStorageFolder, String, FileMode)	Создает безопасный дескриптор для файла, который находится в текущем экземпляре папки хранилища.
CreateSafeFileHandle(IStorageFolder, String, FileMode, FileAccess, FileShare, FileOptions)	Создает безопасный дескриптор для файла, который находится в текущем экземпляре папки хранилища.
OpenStreamForReadAsync(IStorageFile)	Извлекает поток для чтения из указанного файла.
OpenStreamForReadAsync(IStorageFolder, String)	Извлекает поток для чтения из файла в указанной родительской папке.
OpenStreamForWriteAsync(IStorageFile)	Извлекает поток для записи в указанный файл.
OpenStreamForWriteAsync(IStorageFolder, String, CreationCollisionOption)	Извлекает поток для записи в файл в указанной родительской папке.