WindowsRuntimeStreamExtensions.AsStreamForRead Méthode

  • Référence

Définition

Espace de noms:
System.IO
Assembly:
System.Runtime.WindowsRuntime.dll

Surcharges

AsStreamForRead(IInputStream)

Convertit un flux d’entrée dans Windows Runtime en flux managé dans .NET pour les applications du Windows Store.
AsStreamForRead(IInputStream, Int32)

Convertit un flux d’entrée dans Windows Runtime en flux managé dans les applications .NET pour windows 8.x Store à l’aide de la taille de mémoire tampon spécifiée.

AsStreamForRead(IInputStream)

Important

Cette API n’est pas conforme CLS.

Convertit un flux d’entrée dans Windows Runtime en flux managé dans .NET pour les applications du Windows Store.

public:
[System::Runtime::CompilerServices::Extension]
 static System::IO::Stream ^ AsStreamForRead(Windows::Storage::Streams::IInputStream ^ windowsRuntimeStream);
[System.CLSCompliant(false)]
public static System.IO.Stream AsStreamForRead (this Windows.Storage.Streams.IInputStream windowsRuntimeStream);
[<System.CLSCompliant(false)>]
static member AsStreamForRead : Windows.Storage.Streams.IInputStream -> System.IO.Stream
<Extension()>
Public Function AsStreamForRead (windowsRuntimeStream As IInputStream) As Stream

Paramètres

windowsRuntimeStream
IInputStream

Objet IInputStream Windows Runtime à convertir.

Retours

Stream

Flux converti.

Attributs
CLSCompliantAttribute

Exceptions

ArgumentNullException

windowsRuntimeStream est null.

Exemples

L’exemple suivant montre comment utiliser les méthodes AsStreamForWrite et AsStreamForRead pour convertir un flux managé vers et à partir d’un flux dans Windows Runtime.

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

Note

Dans Visual Basic et C#, vous pouvez appeler cette méthode en tant que méthode d’instance sur n’importe quel objet de type Stream. Lorsque vous utilisez la syntaxe de méthode d’instance pour appeler cette méthode, omettez le premier paramètre. Pour plus d’informations, consultez méthodes d’extension (Visual Basic) ou méthodes d’extension (Guide de programmation C#).

Une taille de mémoire tampon par défaut de 16 384 octets est utilisée lors de la conversion du flux. Pour spécifier une taille de mémoire tampon différente, utilisez la surcharge AsStreamForRead(IInputStream, Int32).

S’applique à

AsStreamForRead(IInputStream, Int32)

Important

Cette API n’est pas conforme CLS.

Convertit un flux d’entrée dans Windows Runtime en flux managé dans les applications .NET pour windows 8.x Store à l’aide de la taille de mémoire tampon spécifiée.

public:
[System::Runtime::CompilerServices::Extension]
 static System::IO::Stream ^ AsStreamForRead(Windows::Storage::Streams::IInputStream ^ windowsRuntimeStream, int bufferSize);
[System.CLSCompliant(false)]
public static System.IO.Stream AsStreamForRead (this Windows.Storage.Streams.IInputStream windowsRuntimeStream, int bufferSize);
[<System.CLSCompliant(false)>]
static member AsStreamForRead : Windows.Storage.Streams.IInputStream * int -> System.IO.Stream
<Extension()>
Public Function AsStreamForRead (windowsRuntimeStream As IInputStream, bufferSize As Integer) As Stream

Paramètres

windowsRuntimeStream
IInputStream

Objet IInputStream Windows Runtime à convertir.

bufferSize
Int32

Taille, en octets, de la mémoire tampon. Cette valeur ne peut pas être négative, mais elle peut être égale à 0 (zéro) pour désactiver la mise en mémoire tampon.

Retours

Stream

Flux converti.

Attributs
CLSCompliantAttribute

Exceptions

ArgumentNullException

windowsRuntimeStream est null.

ArgumentOutOfRangeException

bufferSize est négative.

Remarques

Note

Dans Visual Basic et C#, vous pouvez appeler cette méthode en tant que méthode d’instance sur n’importe quel objet de type Stream. Lorsque vous utilisez la syntaxe de méthode d’instance pour appeler cette méthode, omettez le premier paramètre. Pour plus d’informations, consultez méthodes d’extension (Visual Basic) ou méthodes d’extension (Guide de programmation C#).

Vous utilisez cette méthode pour spécifier une taille de mémoire tampon lors de la conversion du flux. Pour utiliser la taille de mémoire tampon par défaut de 16 384 octets, utilisez la surcharge AsStreamForRead(IInputStream).

Dans la plupart des cas, la mise en mémoire tampon améliore les performances des opérations de flux. Vous pouvez désactiver la mise en mémoire tampon en définissant bufferSize sur zéro, mais vous devez le faire uniquement lorsque vous êtes sûr que la désactivation de la mise en mémoire tampon est appropriée pour votre situation.

S’applique à