WindowsRuntimeStreamExtensions.AsStreamForWrite Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.IO
Assembly:
System.Runtime.WindowsRuntime.dll

Overload

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.

AsStreamForWrite(IOutputStream)

Importante

Questa API non è conforme a CLS.

Converte un flusso di output in Windows Runtime in un flusso gestito in .NET per app di Windows 8.x Store.

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);
[<System.CLSCompliant(false)>]
static member AsStreamForWrite : Windows.Storage.Streams.IOutputStream -> System.IO.Stream
<Extension()>
Public Function AsStreamForWrite (windowsRuntimeStream As IOutputStream) As Stream

Parametri

windowsRuntimeStream
IOutputStream

Oggetto IOutputStream di Windows Runtime da convertire.

Restituisce

Stream

Flusso convertito.

Attributi
CLSCompliantAttribute

Eccezioni

ArgumentNullException

windowsRuntimeStream è null.

Esempio

Nell'esempio seguente viene illustrato come usare i AsStreamForWrite metodi e AsStreamForRead per convertire un flusso gestito in e da un flusso nel 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

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

Nota

In Visual Basic e C#è possibile chiamare questo metodo come metodo di istanza in qualsiasi oggetto di tipo Stream. Per chiamare il metodo usando la sintassi del metodo di istanza, omettere il primo parametro. Per altre informazioni, vedere Metodi di estensione (Visual Basic) o metodi di estensione (Guida per programmatori C#).

Durante la conversione del flusso viene usata una dimensione del buffer predefinita di 16.384 byte. Per specificare una dimensione del buffer diversa, usare l'overload AsStreamForWrite(IOutputStream, Int32) .

Si applica a

AsStreamForWrite(IOutputStream, Int32)

Importante

Questa API non è conforme a CLS.

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.

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);
[<System.CLSCompliant(false)>]
static member AsStreamForWrite : Windows.Storage.Streams.IOutputStream * int -> System.IO.Stream
<Extension()>
Public Function AsStreamForWrite (windowsRuntimeStream As IOutputStream, bufferSize As Integer) As Stream

Parametri

windowsRuntimeStream
IOutputStream

Oggetto IOutputStream di Windows Runtime da convertire.

bufferSize
Int32

Dimensione del buffer, in byte. Questo valore non può essere negativo, ma può essere 0 (zero) per disabilitare la memorizzazione nel buffer.

Restituisce

Stream

Flusso convertito.

Attributi
CLSCompliantAttribute

Eccezioni

ArgumentNullException

windowsRuntimeStream è null.

ArgumentOutOfRangeException

bufferSize è negativo.

Commenti

Nota

In Visual Basic e C#è possibile chiamare questo metodo come metodo di istanza in qualsiasi oggetto di tipo Stream. Per chiamare il metodo usando la sintassi del metodo di istanza, omettere il primo parametro. Per altre informazioni, vedere Metodi di estensione (Visual Basic) o Metodi di estensione (Guida per programmatori C#).

Questo metodo consente di specificare le dimensioni del buffer durante la conversione del flusso. Per usare le dimensioni predefinite del buffer di 16.384 byte, usare l'overload AsStreamForWrite(IOutputStream) .

Nella maggior parte dei casi, il buffering migliora le prestazioni delle operazioni di flusso. È possibile disabilitare il buffer impostando bufferSize su zero, ma è consigliabile farlo solo quando si è certi che la disabilitazione del buffering sia appropriata per la situazione.

Si applica a