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

public static class WindowsRuntimeStorageExtensions

[System.Security.SecurityCritical]
public static class WindowsRuntimeStorageExtensions

type WindowsRuntimeStorageExtensions = class

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

Public Module WindowsRuntimeStorageExtensions

Vererbung: Object
WindowsRuntimeStorageExtensions

Attribute: SecurityCriticalAttribute

Beispiele

Das folgende Beispiel zeigt, wie Sie eine Datei in den Anwendungsdaten als Stream eine in einer Windows Store-App öffnen und mithilfe einer Instanz der StreamWriter Klasse darauf schreiben. Anschließend wird der Inhalt für die Datei mithilfe einer Instanz 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 bequeme Möglichkeiten zum Öffnen von Dateien zum Lesen oder Schreiben in Windows Store Apps. Sie erstellen keine Instanz der WindowsRuntimeStorageExtensions Klasse. Stattdessen verwenden Sie diese Methoden aus Instanzen der IStorageFile und IStorageFolder Schnittstellen.

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

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

Methoden

CreateSafeFileHandle(IStorageFile, FileAccess, FileShare, FileOptions)	Erstellt einen sicheren Dateihandle für die aktuelle Instanz der Speicherdatei
CreateSafeFileHandle(IStorageFolder, String, FileMode)	Erstellt einen sicheren Dateihandle für eine Datei, die sich in der aktuellen Speicherordnerinstanz befindet
CreateSafeFileHandle(IStorageFolder, String, FileMode, FileAccess, FileShare, FileOptions)	Erstellt einen sicheren Dateihandle für eine Datei, die sich in der aktuellen Speicherordnerinstanz befindet
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