WindowsRuntimeStreamExtensions.AsStreamForWrite Метод

Определение

Перегрузки

AsStreamForWrite(IOutputStream)

Преобразует поток вывода в среде выполнения Windows в управляемый поток в .NET для приложений Магазина Windows 8.x.

AsStreamForWrite(IOutputStream, Int32)

Преобразует поток вывода в среде выполнения Windows в управляемый поток в .NET для приложений Магазина Windows с использованием указанного размера буфера.

AsStreamForWrite(IOutputStream)

Важно!

Этот API несовместим с CLS.

Преобразует поток вывода в среде выполнения Windows в управляемый поток в .NET для приложений Магазина Windows 8.x.

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

Параметры

windowsRuntimeStream
IOutputStream

Преобразуемый объект IOutputStream среды выполнения Windows.

Возвращаемое значение

Преобразованный поток.

Атрибуты

Исключения

windowsRuntimeStream имеет значение null.

Примеры

В следующем примере показано, как использовать AsStreamForWrite методы и AsStreamForRead для преобразования управляемого потока в поток в среда выполнения Windows и из нее.

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

Ниже приведен код XAML, связанный с предыдущим примером.

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

Комментарии

Примечание

В Visual Basic и C# этот метод можно вызвать как метод экземпляра для любого объекта типа Stream. При вызове метода для экземпляра следует опускать первый параметр. Дополнительные сведения см. в разделах Методы расширения (Visual Basic) или Методы расширения (руководство по программированию на C#).

При преобразовании потока используется размер буфера по умолчанию 16 384 байта. Чтобы указать другой размер буфера, используйте перегрузку AsStreamForWrite(IOutputStream, Int32) .

Применяется к

AsStreamForWrite(IOutputStream, Int32)

Важно!

Этот API несовместим с CLS.

Преобразует поток вывода в среде выполнения Windows в управляемый поток в .NET для приложений Магазина Windows с использованием указанного размера буфера.

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

Параметры

windowsRuntimeStream
IOutputStream

Преобразуемый объект IOutputStream среды выполнения Windows.

bufferSize
Int32

Размер (в байтах) буфера. Это значение не может быть отрицательным, но оно может быть равно нулю для отключения буферизацию.

Возвращаемое значение

Преобразованный поток.

Атрибуты

Исключения

windowsRuntimeStream имеет значение null.

bufferSize является отрицательным значением.

Комментарии

Примечание

В Visual Basic и C# этот метод можно вызвать как метод экземпляра для любого объекта типа Stream. При вызове метода для экземпляра следует опускать первый параметр. Дополнительные сведения см. в разделах Методы расширения (Visual Basic) или Методы расширения (руководство по программированию на C#).

Этот метод используется для указания размера буфера при преобразовании потока. Чтобы использовать размер буфера по умолчанию 16 384 байта, используйте перегрузку AsStreamForWrite(IOutputStream) .

В большинстве случаев буферизация повышает производительность потоковых операций. Вы можете отключить буферизацию, присвоив значение bufferSize нулю, но это следует делать только в том случае, если вы уверены, что отключение буферизации подходит для вашей ситуации.

Применяется к