WindowsRuntimeStreamExtensions Classe

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.WindowsRuntime.dll

Contient des méthodes d’extension pour la conversion de flux dans le Windows Runtime et de flux managés dans .NET pour les applications Microsoft Store.

public ref class WindowsRuntimeStreamExtensions abstract sealed

public static class WindowsRuntimeStreamExtensions

type WindowsRuntimeStreamExtensions = class

Public Module WindowsRuntimeStreamExtensions

Héritage

Object

WindowsRuntimeStreamExtensions

Exemples

L’exemple suivant montre comment utiliser et 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

Voici le code XAML associé à l’exemple précédent.

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

Remarques

Ces méthodes d’extension sont disponibles uniquement lorsque vous développez des applications du Windows Store. Les méthodes fournissent des moyens pratiques d’utiliser des flux dans les applications du Windows Store. Vous ne créez pas de instance de la WindowsRuntimeStreamExtensions classe ; au lieu de cela, vous utilisez ces méthodes à partir d’instances des IInputStream interfaces et et IOutputStream de la Stream classe .

La WindowsRuntimeStreamExtensions classe contient deux méthodes pour convertir un objet managé Stream en flux dans le Windows Runtime :

• AsInputStream
• AsOutputStream

La WindowsRuntimeStreamExtensions classe contient trois méthodes surchargées pour convertir un flux dans le Windows Runtime en objet Stream :

• AsStream
• AsStreamForRead
• AsStreamForWrite

À compter de .NET Framework 4.5.1, la WindowsRuntimeStreamExtensions classe contient une méthode permettant de convertir un flux en Windows Runtime RandomAccessStream:

• AsRandomAccessStream(Stream)

Méthodes

AsInputStream(Stream)	Convertit un flux managé dans .NET pour les applications du Windows Store en un flux d’entrée Windows Runtime.
AsOutputStream(Stream)	Convertit un flux managé dans .NET pour les applications du Windows Store en un flux de sortie Windows Runtime.
AsRandomAccessStream(Stream)	Convertit le flux spécifié en flux d'accès aléatoire.
AsStream(IRandomAccessStream)	Convertit un flux d’accès aléatoire Windows Runtime en un flux managé dans .NET pour les applications du Windows Store.
AsStream(IRandomAccessStream, Int32)	Convertit un flux d’accès aléatoire Windows Runtime en un flux managé dans .NET pour les applications du Windows Store utilisant la taille de mémoire tampon spécifiée.
AsStreamForRead(IInputStream)	Convertit un flux d’entrée Windows Runtime en un flux managé dans .NET pour les applications du Windows Store.
AsStreamForRead(IInputStream, Int32)	Convertit un flux d’entrée dans Windows Runtime en un flux managé dans .NET pour les applications du Windows 8.x Store utilisant la taille de mémoire tampon spécifiée.
AsStreamForWrite(IOutputStream)	Convertit un flux de sortie Windows Runtime en un flux managé dans .NET pour les applications du Windows 8.x Store.
AsStreamForWrite(IOutputStream, Int32)	Convertit un flux de sortie dans Windows Runtime en un flux managé dans .NET pour les applications du Windows Store utilisant la taille de mémoire tampon spécifiée.