WindowsRuntimeStreamExtensions.AsStreamForRead 方法

參考

定義

命名空間:: System.IO

組件:: System.Runtime.WindowsRuntime.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

AsStreamForRead(IInputStream)	將 Windows 執行階段中的輸入資料流轉換成適用於 Windows 市集應用程式的 .NET 中的受控資料流。
AsStreamForRead(IInputStream, Int32)	使用指定的緩衝區大小將 Windows 執行階段中的輸入資料流轉換成適用於 Windows 8.x 市集應用程式的 .NET 中的受控資料流。

AsStreamForRead(IInputStream)

重要

此 API 不符合 CLS 規範。

將 Windows 執行階段中的輸入資料流轉換成適用於 Windows 市集應用程式的 .NET 中的受控資料流。

public:
[System::Runtime::CompilerServices::Extension]
 static System::IO::Stream ^ AsStreamForRead(Windows::Storage::Streams::IInputStream ^ windowsRuntimeStream);

[System.CLSCompliant(false)]
public static System.IO.Stream AsStreamForRead (this Windows.Storage.Streams.IInputStream windowsRuntimeStream);

[<System.CLSCompliant(false)>]
static member AsStreamForRead : Windows.Storage.Streams.IInputStream -> System.IO.Stream

<Extension()>
Public Function AsStreamForRead (windowsRuntimeStream As IInputStream) As Stream

參數

windowsRuntimeStream: IInputStream

要轉換的 Windows 執行階段 IInputStream 物件。

傳回

Stream

轉換的資料流。

屬性: CLSCompliantAttribute

例外狀況

ArgumentNullException

windowsRuntimeStream 為 null。

範例

下列範例示範如何使用 AsStreamForWrite 和 AsStreamForRead 方法，將 Managed 數據流轉換成 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 個字節。若要指定不同的緩衝區大小，請使用 AsStreamForRead(IInputStream, Int32) 多載。

適用於

AsStreamForRead(IInputStream, Int32)

重要

此 API 不符合 CLS 規範。

使用指定的緩衝區大小將 Windows 執行階段中的輸入資料流轉換成適用於 Windows 8.x 市集應用程式的 .NET 中的受控資料流。

public:
[System::Runtime::CompilerServices::Extension]
 static System::IO::Stream ^ AsStreamForRead(Windows::Storage::Streams::IInputStream ^ windowsRuntimeStream, int bufferSize);

[System.CLSCompliant(false)]
public static System.IO.Stream AsStreamForRead (this Windows.Storage.Streams.IInputStream windowsRuntimeStream, int bufferSize);

[<System.CLSCompliant(false)>]
static member AsStreamForRead : Windows.Storage.Streams.IInputStream * int -> System.IO.Stream

<Extension()>
Public Function AsStreamForRead (windowsRuntimeStream As IInputStream, bufferSize As Integer) As Stream

參數

windowsRuntimeStream: IInputStream

要轉換的 Windows 執行階段 IInputStream 物件。

bufferSize: Int32

緩衝區的大小 (以位元組為單位)。這個值不可以是負數，但可以是 0 (零)，以停用緩衝處理。

傳回

Stream

轉換的資料流。

屬性: CLSCompliantAttribute

例外狀況

ArgumentNullException

windowsRuntimeStream 為 null。

ArgumentOutOfRangeException

bufferSize 為負。

備註

注意

在轉換數據流時，您可以使用這個方法來指定緩衝區大小。若要使用默認緩衝區大小 16,384 個字節，請使用多 AsStreamForRead(IInputStream) 載。

在大部分情況下，緩衝可改善數據流作業的效能。您可以藉由將設定 bufferSize 為零來停用緩衝，但只有在確定停用緩衝適用於您的情況時，才應該這麼做。

適用於

共用方式為

WindowsRuntimeStreamExtensions.AsStreamForRead 方法

定義

多載

AsStreamForRead(IInputStream)

參數

傳回

例外狀況

範例

備註

適用於

AsStreamForRead(IInputStream, Int32)

參數

傳回

例外狀況

備註

適用於

其他資源