WindowsRuntimeStreamExtensions.AsStreamForWrite Méthode

Définition

Surcharges

AsStreamForWrite(IOutputStream)

Convertit un flux de sortie Windows Runtime en un flux managé dans .NET pour les applications du Windows 8.x Store.Converts an output stream in the Windows Runtime to a managed stream in the .NET for Windows 8.x Store apps.

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.Converts an output stream in the Windows Runtime to a managed stream in the .NET for Windows Store apps using the specified buffer size.

AsStreamForWrite(IOutputStream)

Important

Cette API n’est pas conforme CLS.

Convertit un flux de sortie Windows Runtime en un flux managé dans .NET pour les applications du Windows 8.x Store.Converts an output stream in the Windows Runtime to a managed stream in the .NET for Windows 8.x Store apps.

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

Paramètres

windowsRuntimeStream
IOutputStream

Objet Windows Runtime à convertir.The Windows Runtime object to convert.

Retours

Stream

Flux converti.The converted stream.

Attributs

Exceptions

windowsRuntimeStream a la valeur null.windowsRuntimeStream is 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 de la Windows Runtime.The following example shows how to use the AsStreamForWrite and AsStreamForRead methods to convert a managed stream to and from a stream in the 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.Here's the XAML code that is associated with the previous example.

<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

Notes

Dans Visual Basic et C#, vous pouvez appeler cette méthode comme une méthode d’instance sur n’importe quel objet de type Stream.In Visual Basic and C#, you can call this method as an instance method on any object of type Stream. Lorsque vous utilisez la syntaxe des méthodes d'instance pour appeler cette méthode, omettez le premier paramètre.When you use instance method syntax to call this method, omit the first parameter. Pour plus d’informations, consultez méthodes d’extension (Visual Basic) ou méthodesC# d’extension (Guide de programmation).For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Une taille de mémoire tampon par défaut de 16 384 octets est utilisée lors de la conversion du flux.A default buffer size of 16,384 bytes is used when converting the stream. Pour spécifier une taille de mémoire tampon différente, utilisez la surcharge AsStreamForWrite(IOutputStream, Int32).To specify a different buffer size, use the AsStreamForWrite(IOutputStream, Int32) overload.

AsStreamForWrite(IOutputStream, Int32)

Important

Cette API n’est pas conforme CLS.

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.Converts an output stream in the Windows Runtime to a managed stream in the .NET for Windows Store apps using the specified buffer size.

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

Paramètres

windowsRuntimeStream
IOutputStream

Objet IOutputStream Windows Runtime à convertir.The Windows Runtime IOutputStream object to convert.

bufferSize
Int32

Taille en octets de la mémoire tampon.The size, in bytes, of the buffer. Cette valeur ne peut pas être négative, mais elle peut avoir la valeur 0 (zéro) pour désactiver la mise en mémoire tampon.This value cannot be negative, but it can be 0 (zero) to disable buffering.

Retours

Stream

Flux converti.The converted stream.

Attributs

Exceptions

windowsRuntimeStream a la valeur null.windowsRuntimeStream is null.

bufferSize est un nombre négatif.bufferSize is negative.

Remarques

Notes

Dans Visual Basic et C#, vous pouvez appeler cette méthode comme une méthode d’instance sur n’importe quel objet de type Stream.In Visual Basic and C#, you can call this method as an instance method on any object of type Stream. Lorsque vous utilisez la syntaxe des méthodes d'instance pour appeler cette méthode, omettez le premier paramètre.When you use instance method syntax to call this method, omit the first parameter. Pour plus d’informations, consultez méthodes d’extension (Visual Basic) ou méthodesC# d’extension (Guide de programmation).For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Vous utilisez cette méthode pour spécifier une taille de mémoire tampon lors de la conversion du flux.You use this method to specify a buffer size when converting the stream. Pour utiliser la taille de mémoire tampon par défaut de 16 384 octets, utilisez la surcharge AsStreamForWrite(IOutputStream).To use the default buffer size of 16,384 bytes, use the AsStreamForWrite(IOutputStream) overload.

Dans la plupart des cas, la mise en mémoire tampon améliore les performances des opérations de flux.In most situations, buffering improves the performance of stream operations. Vous pouvez désactiver la mise en mémoire tampon en affectant la valeur zéro à bufferSize, mais vous ne devez effectuer cette opération que si vous êtes sûr que la désactivation de la mise en mémoire tampon est adaptée à votre situation.You can disable buffering by setting bufferSize to zero, but you should do this only when you are sure that disabling buffering is appropriate for your situation.

S’applique à