Поделиться через

WindowsRuntimeStreamExtensions.AsStreamForRead Метод

  • Ссылка

Определение

Пространство имен:
System.IO
Сборка:
System.Runtime.WindowsRuntime.dll

Перегрузки

AsStreamForRead(IInputStream)

Преобразует входной поток в среде выполнения Windows в управляемый поток в .NET для приложений Магазина Windows.
AsStreamForRead(IInputStream, Int32)

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

AsStreamForRead(IInputStream)

Важно!

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

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

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 для преобразования управляемого потока в поток в среду выполнения 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 в управляемый поток в приложениях Магазина .NET для Windows 8.x, используя указанный размер буфера.

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 отрицательно.

Комментарии

Заметка

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

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

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

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