WindowsRuntimeStorageExtensions Klasse

Referenz

Definition

Namespace:: System.IO

Assembly:: System.Runtime.WindowsRuntime.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Enthält Erweiterungsmethoden für IStorageFile und IStorageFolder-Schnittstellen in der Windows-Runtime bei der Entwicklung von Microsoft Store-Apps.

public ref class WindowsRuntimeStorageExtensions abstract sealed

[System.Security.SecurityCritical]
public static class WindowsRuntimeStorageExtensions

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

Public Module WindowsRuntimeStorageExtensions

Vererbung: Object
WindowsRuntimeStorageExtensions

Attribute: SecurityCriticalAttribute

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie eine Datei in den Anwendungsdaten als in Stream einer Windows Store-App öffnen und mithilfe eines instance der -Klasse in sie StreamWriter schreiben. Anschließend wird der Inhalt der Datei mithilfe einer instance der StreamReader -Klasse gelesen.

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

Das nächste Beispiel zeigt den XAML-Code, der dem vorherigen Beispiel zugeordnet ist.

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

Hinweise

Diese Erweiterungsmethoden sind nur verfügbar, wenn Sie Windows Store-Apps entwickeln. Die Methoden bieten praktische Möglichkeiten zum Öffnen von Dateien zum Lesen oder Schreiben in Windows Store-Apps. Sie erstellen keine instance der WindowsRuntimeStorageExtensions -Klasse. Stattdessen verwenden Sie diese Methoden aus Instanzen der - und IStorageFolder -IStorageFileSchnittstelle.

Die WindowsRuntimeStorageExtensions -Klasse enthält zwei Methoden, die zum Lesen oder Schreiben erweitert IStorageFile werden:

Die WindowsRuntimeStorageExtensions-Klasse enthält zwei Methoden, die zum Lesen und Schreiben erweitert IStorageFolder werden:

Methoden

OpenStreamForReadAsync(IStorageFile)	Ruft einen Stream zum Lesen aus einer angegebenen Datei ab.
OpenStreamForReadAsync(IStorageFolder, String)	Ruft einen Stream zum Lesen aus einer Datei im angegebenen übergeordneten Ordner ab.
OpenStreamForWriteAsync(IStorageFile)	Ruft einen Stream zum Schreiben in eine angegebene Datei ab.
OpenStreamForWriteAsync(IStorageFolder, String, CreationCollisionOption)	Ruft einen Stream zum Schreiben in eine Datei im angegebenen übergeordneten Ordner ab.

Gilt für:

Teilen über