WindowsRuntimeStreamExtensions Classe

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.WindowsRuntime.dll

Contiene metodi di estensione per la conversione tra i flussi in Windows Runtime e i flussi gestiti in .NET per le app di Windows Store.

public ref class WindowsRuntimeStreamExtensions abstract sealed

public static class WindowsRuntimeStreamExtensions

type WindowsRuntimeStreamExtensions = class

Public Module WindowsRuntimeStreamExtensions

Ereditarietà

Object

WindowsRuntimeStreamExtensions

Esempio

Nell'esempio seguente viene illustrato come usare e AsStreamForWriteAsStreamForRead

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

Ecco il codice XAML associato all'esempio precedente.

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

Commenti

Questi metodi di estensione sono disponibili solo quando si sviluppano app di Windows Store. I metodi offrono modi pratici per usare i flussi nelle app di Windows Store. Non si crea un'istanza della WindowsRuntimeStreamExtensions classe; invece, si usano questi metodi da istanze delle IInputStream interfacce e IOutputStream e della Stream classe.

La WindowsRuntimeStreamExtensions classe contiene due metodi per convertire un oggetto gestito Stream in un flusso nella Windows Runtime:

• AsInputStream
• AsOutputStream

La WindowsRuntimeStreamExtensions classe contiene tre metodi di overload per la conversione di un flusso nel Windows Runtime in un Stream oggetto:

• AsStream
• AsStreamForRead
• AsStreamForWrite

A partire da .NET Framework 4.5.1, la WindowsRuntimeStreamExtensions classe contiene un metodo per convertire un flusso in un Windows Runtime RandomAccessStream:

• AsRandomAccessStream(Stream)

Metodi

AsInputStream(Stream)	Converte un flusso gestito in .NET per app di Windows Store in un flusso di input in Windows Runtime.
AsOutputStream(Stream)	Converte un flusso gestito in .NET per app di Windows Store in un flusso di output in Windows Runtime.
AsRandomAccessStream(Stream)	Converte il flusso specificato in un flusso di accesso casuale.
AsStream(IRandomAccessStream)	Converte un flusso ad accesso casuale in Windows Runtime in un flusso gestito in .NET per app di Windows Store.
AsStream(IRandomAccessStream, Int32)	Converte un flusso ad accesso casuale in Windows Runtime in un flusso gestito in .NET per app di Windows Store usando le dimensioni del buffer specificate.
AsStreamForRead(IInputStream)	Converte un flusso di input in Windows Runtime in un flusso gestito in .NET per app di Windows Store.
AsStreamForRead(IInputStream, Int32)	Converte un flusso di input in Windows Runtime in un flusso gestito in .NET per app di Windows 8.x Store usando le dimensioni del buffer specificate.
AsStreamForWrite(IOutputStream)	Converte un flusso di output in Windows Runtime in un flusso gestito in .NET per app di Windows 8.x Store.
AsStreamForWrite(IOutputStream, Int32)	Converte un flusso di output in Windows Runtime in un flusso gestito in .NET per app di Windows Store usando le dimensioni del buffer specificate.