WindowsRuntimeStreamExtensions.AsStreamForWrite Metoda

Definicja

Przeciążenia

AsStreamForWrite(IOutputStream)

Konwertuje strumień wyjściowy w środowisko wykonawcze systemu Windows na zarządzany strumień w aplikacjach ze sklepu .NET dla systemu Windows 8. x.Converts an output stream in the Windows Runtime to a managed stream in the .NET for Windows 8.x Store apps.

AsStreamForWrite(IOutputStream, Int32)

Konwertuje strumień wyjściowy w środowisko wykonawcze systemu Windows na zarządzany strumień w programie .NET dla aplikacji do sklepu Windows przy użyciu określonego rozmiaru buforu.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)

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Konwertuje strumień wyjściowy w środowisko wykonawcze systemu Windows na zarządzany strumień w aplikacjach ze sklepu .NET dla systemu Windows 8. x.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);
[<System.CLSCompliant(false)>]
static member AsStreamForWrite : Windows.Storage.Streams.IOutputStream -> System.IO.Stream
<Extension()>
Public Function AsStreamForWrite (windowsRuntimeStream As IOutputStream) As Stream

Parametry

windowsRuntimeStream
IOutputStream

Obiekt środowisko wykonawcze systemu Windows do przekonwertowania.The Windows Runtime object to convert.

Zwraca

Stream

Przekonwertowany strumień.The converted stream.

Atrybuty

Wyjątki

windowsRuntimeStream to null.windowsRuntimeStream is null.

Przykłady

Poniższy przykład pokazuje, jak używać AsStreamForWrite AsStreamForRead metod i do konwertowania zarządzanego strumienia do i ze strumienia w środowisko wykonawcze systemu Windows.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

Oto kod XAML, który jest skojarzony z poprzednim przykładem.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>

Uwagi

Uwaga

W Visual Basic i C# można wywołać tę metodę jako metodę wystąpienia dla każdego obiektu typu Stream .In Visual Basic and C#, you can call this method as an instance method on any object of type Stream. Gdy w celu wywołania tej metody jest używana składnia metody wystąpienia, należy pominąć pierwszy parametr.When you use instance method syntax to call this method, omit the first parameter. Aby uzyskać więcej informacji, zobacz metody rozszerzania (Visual Basic) lub metody rozszerzenia (Przewodnik programowania w języku C#).For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Podczas konwertowania strumienia używany jest domyślny rozmiar buforu 16 384 bajtów.A default buffer size of 16,384 bytes is used when converting the stream. Aby określić inny rozmiar buforu, użyj AsStreamForWrite(IOutputStream, Int32) przeciążenia.To specify a different buffer size, use the AsStreamForWrite(IOutputStream, Int32) overload.

Dotyczy

AsStreamForWrite(IOutputStream, Int32)

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Konwertuje strumień wyjściowy w środowisko wykonawcze systemu Windows na zarządzany strumień w programie .NET dla aplikacji do sklepu Windows przy użyciu określonego rozmiaru buforu.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);
[<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

Parametry

windowsRuntimeStream
IOutputStream

Obiekt środowisko wykonawcze systemu Windows IOutputStream do przekonwertowania.The Windows Runtime IOutputStream object to convert.

bufferSize
Int32

Rozmiar bufora (w bajtach).The size, in bytes, of the buffer. Ta wartość nie może być ujemna, ale może być równa 0 (zero), aby wyłączyć buforowanie.This value cannot be negative, but it can be 0 (zero) to disable buffering.

Zwraca

Stream

Przekonwertowany strumień.The converted stream.

Atrybuty

Wyjątki

windowsRuntimeStream to null.windowsRuntimeStream is null.

bufferSize jest wartością ujemną.bufferSize is negative.

Uwagi

Uwaga

W Visual Basic i C# można wywołać tę metodę jako metodę wystąpienia dla każdego obiektu typu Stream .In Visual Basic and C#, you can call this method as an instance method on any object of type Stream. Gdy w celu wywołania tej metody jest używana składnia metody wystąpienia, należy pominąć pierwszy parametr.When you use instance method syntax to call this method, omit the first parameter. Aby uzyskać więcej informacji, zobacz metody rozszerzania (Visual Basic) lub metody rozszerzenia (Przewodnik programowania w języku C#).For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Ta metoda pozwala określić rozmiar buforu podczas konwertowania strumienia.You use this method to specify a buffer size when converting the stream. Aby użyć domyślnego rozmiaru buforu 16 384 bajtów, użyj AsStreamForWrite(IOutputStream) przeciążenia.To use the default buffer size of 16,384 bytes, use the AsStreamForWrite(IOutputStream) overload.

W większości sytuacji buforowanie zwiększa wydajność operacji przesyłania strumieniowego.In most situations, buffering improves the performance of stream operations. Buforowanie można wyłączyć przez ustawienie bufferSize wartości zero, ale należy to zrobić tylko wtedy, gdy masz pewność, że wyłączenie buforowania jest odpowiednie dla danej sytuacji.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.

Dotyczy