WindowsRuntimeStreamExtensions.AsStreamForWrite Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.IO
Bütünleştirilmiş Kod:
System.Runtime.WindowsRuntime.dll

Aşırı Yüklemeler

AsStreamForWrite(IOutputStream)

Windows Çalışma Zamanı bir çıkış akışını Windows 8.x Store uygulamaları için .NET'te yönetilen akışa dönüştürür.
AsStreamForWrite(IOutputStream, Int32)

Windows Çalışma Zamanı bir çıkış akışını, belirtilen arabellek boyutunu kullanarak Windows Mağazası uygulamaları için .NET'te yönetilen akışa dönüştürür.

AsStreamForWrite(IOutputStream)

Önemli

Bu API, CLS uyumlu değildir.

Windows Çalışma Zamanı bir çıkış akışını Windows 8.x Store uygulamaları için .NET'te yönetilen akışa dönüştürür.

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

Parametreler

windowsRuntimeStream
IOutputStream

Dönüştürülecek Windows Çalışma Zamanı IOutputStream nesnesi.

Döndürülenler

Stream

Dönüştürülen akış.

Öznitelikler
CLSCompliantAttribute

Özel durumlar

ArgumentNullException

windowsRuntimeStream, null değeridir.

Örnekler

Aşağıdaki örnek, yönetilen bir akışı Windows Çalışma Zamanı bir akışa ve akıştan dönüştürmek için ve AsStreamForRead yöntemlerinin nasıl kullanılacağını AsStreamForWrite gösterir.

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

Önceki örnekle ilişkili XAML kodu aşağıda verilmiştir.

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

Açıklamalar

Not

Visual Basic ve C# içinde, türündeki herhangi bir nesnede Streamörnek yöntemi olarak bu yöntemi çağırabilirsiniz. Bu yöntemi çağırmak için örnek yöntemi sözdizimini kullandığınızda, ilk parametreyi yok sayın. Daha fazla bilgi için bkz . Uzantı Yöntemleri (Visual Basic) veya Uzantı Yöntemleri (C# Programlama Kılavuzu).

Akışı dönüştürürken varsayılan 16.384 bayt arabellek boyutu kullanılır. Farklı bir arabellek boyutu belirtmek için aşırı yüklemeyi kullanın AsStreamForWrite(IOutputStream, Int32) .

Şunlara uygulanır

AsStreamForWrite(IOutputStream, Int32)

Önemli

Bu API, CLS uyumlu değildir.

Windows Çalışma Zamanı bir çıkış akışını, belirtilen arabellek boyutunu kullanarak Windows Mağazası uygulamaları için .NET'te yönetilen akışa dönüştürür.

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

Parametreler

windowsRuntimeStream
IOutputStream

Dönüştürülecek Windows Çalışma Zamanı IOutputStream nesnesi.

bufferSize
Int32

Arabelleğin bayt cinsinden boyutu. Bu değer negatif olamaz, ancak arabelleğe almayı devre dışı bırakmak için 0 (sıfır) olabilir.

Döndürülenler

Stream

Dönüştürülen akış.

Öznitelikler
CLSCompliantAttribute

Özel durumlar

ArgumentNullException

windowsRuntimeStream, null değeridir.

ArgumentOutOfRangeException

bufferSize negatiftir.

Açıklamalar

Not

Visual Basic ve C# içinde, türündeki herhangi bir nesnede Streamörnek yöntemi olarak bu yöntemi çağırabilirsiniz. Bu yöntemi çağırmak için örnek yöntemi sözdizimini kullandığınızda, ilk parametreyi yok sayın. Daha fazla bilgi için bkz . Uzantı Yöntemleri (Visual Basic) veya Uzantı Yöntemleri (C# Programlama Kılavuzu).

Akışı dönüştürürken arabellek boyutu belirtmek için bu yöntemi kullanırsınız. Varsayılan arabellek boyutunu 16.384 bayt kullanmak için aşırı yüklemeyi kullanın AsStreamForWrite(IOutputStream) .

Çoğu durumda arabelleğe alma işlemi akış işlemlerinin performansını artırır. Arabelleğe almayı sıfır olarak ayarlayarak bufferSize devre dışı bırakabilirsiniz, ancak bunu yalnızca arabelleği devre dışı bırakmanın durumunuz için uygun olduğundan emin olduğunuzda yapmalısınız.

Şunlara uygulanır