WindowsRuntimeStreamExtensions.AsStreamForWrite Metode

  • Referensi

Definisi

Ruang nama:
System.IO
Rakitan:
System.Runtime.WindowsRuntime.dll

Overload

AsStreamForWrite(IOutputStream)

Mengonversi aliran output di Windows Runtime ke aliran terkelola di .NET untuk aplikasi Windows 8.x Store.
AsStreamForWrite(IOutputStream, Int32)

Mengonversi aliran output di Windows Runtime ke aliran terkelola di aplikasi .NET untuk Windows Store menggunakan ukuran buffer yang ditentukan.

AsStreamForWrite(IOutputStream)

Penting

API ini bukan kompatibel CLS.

Mengonversi aliran output di Windows Runtime ke aliran terkelola di .NET untuk aplikasi 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

Parameter

windowsRuntimeStream
IOutputStream

Objek Windows Runtime IOutputStream yang akan dikonversi.

Mengembalikan

Stream

Aliran yang dikonversi.

Atribut
CLSCompliantAttribute

Pengecualian

ArgumentNullException

windowsRuntimeStreamadalah null.

Contoh

Contoh berikut menunjukkan cara menggunakan AsStreamForWrite metode dan AsStreamForRead untuk mengonversi aliran terkelola ke dan dari aliran di 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

Berikut adalah kode XAML yang terkait dengan contoh sebelumnya.

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

Keterangan

Catatan

Di Visual Basic dan C#, Anda dapat memanggil metode ini sebagai metode instans pada objek jenis Streamapa pun . Saat Anda menggunakan sintaks metode instans untuk memanggil metode ini, hilangkan parameter pertama. Untuk informasi selengkapnya, lihat Metode Ekstensi (Visual Basic) atau Metode Ekstensi (Panduan Pemrograman C#).

Ukuran buffer default 16.384 byte digunakan saat mengonversi aliran. Untuk menentukan ukuran buffer yang berbeda, gunakan AsStreamForWrite(IOutputStream, Int32) kelebihan beban.

Berlaku untuk

AsStreamForWrite(IOutputStream, Int32)

Penting

API ini bukan kompatibel CLS.

Mengonversi aliran output di Windows Runtime ke aliran terkelola di aplikasi .NET untuk Windows Store menggunakan ukuran buffer yang ditentukan.

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

Parameter

windowsRuntimeStream
IOutputStream

Objek Windows Runtime IOutputStream yang akan dikonversi.

bufferSize
Int32

Ukuran, dalam byte, dari buffer. Nilai ini tidak boleh negatif, tetapi bisa 0 (nol) untuk menonaktifkan buffering.

Mengembalikan

Stream

Aliran yang dikonversi.

Atribut
CLSCompliantAttribute

Pengecualian

ArgumentNullException

windowsRuntimeStreamadalah null.

ArgumentOutOfRangeException

bufferSize negatif.

Keterangan

Catatan

Di Visual Basic dan C#, Anda dapat memanggil metode ini sebagai metode instans pada objek jenis Streamapa pun . Saat Anda menggunakan sintaks metode instans untuk memanggil metode ini, hilangkan parameter pertama. Untuk informasi selengkapnya, lihat Metode Ekstensi (Visual Basic) atau Metode Ekstensi (Panduan Pemrograman C#).

Anda menggunakan metode ini untuk menentukan ukuran buffer saat mengonversi aliran. Untuk menggunakan ukuran buffer default 16.384 byte, gunakan AsStreamForWrite(IOutputStream) kelebihan beban.

Dalam kebanyakan situasi, buffering meningkatkan performa operasi streaming. Anda dapat menonaktifkan buffering dengan mengatur bufferSize ke nol, tetapi Anda harus melakukan ini hanya ketika Anda yakin bahwa menonaktifkan buffering sesuai untuk situasi Anda.

Berlaku untuk