WindowsRuntimeStreamExtensions.AsStreamForRead Метод

Определение

Перегрузки

AsStreamForRead(IInputStream)

Преобразует входной поток в среде выполнения Windows в управляемый поток в .NET для приложений Магазина Windows.Converts an input stream in the Windows Runtime to a managed stream in the .NET for Windows Store apps.

AsStreamForRead(IInputStream, Int32)

Преобразует поток входной поток в среде выполнения Windows в управляемый поток в .NET для приложений Магазина Windows с помощью указанного размера буфера.Converts an input stream in the Windows Runtime to a managed stream in the .NET for Windows 8.x Store apps using the specified buffer size.

AsStreamForRead(IInputStream)

Важно!

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

Преобразует входной поток в среде выполнения Windows в управляемый поток в .NET для приложений Магазина Windows.Converts an input stream in the Windows Runtime to a managed stream in the .NET for Windows Store apps.

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);
static member AsStreamForRead : Windows.Storage.Streams.IInputStream -> System.IO.Stream
<Extension()>
Public Function AsStreamForRead (windowsRuntimeStream As IInputStream) As Stream

Параметры

windowsRuntimeStream
IInputStream

Преобразуемый объект IInputStream среды выполнения Windows.The Windows Runtime IInputStream object to convert.

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

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

Атрибуты

Исключения

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

Примеры

В следующем примере показано, как использовать методы AsStreamForWrite и AsStreamForRead для преобразования управляемого потока в поток в среда выполнения Windows и из него.The following example shows how to use the AsStreamForWrite and AsStreamForRead methods to convert a managed stream to and from a stream in the 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

Ниже приведен код XAML, связанный с предыдущим примером.Here's the XAML code that is associated with the previous example.

<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.In Visual Basic and C#, you can call this method as an instance method on any object of type Stream. При вызове метода для экземпляра следует опускать первый параметр.When you use instance method syntax to call this method, omit the first parameter. Дополнительные сведения см. в разделе методы расширения (Visual Basic) или методы расширенияC# (руководством по программированию).For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Размер буфера по умолчанию (16 384 байт) используется при преобразовании потока.A default buffer size of 16,384 bytes is used when converting the stream. Чтобы указать другой размер буфера, используйте перегрузку AsStreamForRead(IInputStream, Int32).To specify a different buffer size, use the AsStreamForRead(IInputStream, Int32) overload.

AsStreamForRead(IInputStream, Int32)

Важно!

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

Преобразует поток входной поток в среде выполнения Windows в управляемый поток в .NET для приложений Магазина Windows с помощью указанного размера буфера.Converts an input stream in the Windows Runtime to a managed stream in the .NET for Windows 8.x Store apps using the specified buffer size.

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);
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.The Windows Runtime object to convert.

bufferSize
Int32

Размер (в байтах) буфера.The size, in bytes, of the buffer. Это значение не может быть отрицательным, но оно может быть равно нулю для отключения буферизацию.This value cannot be negative, but it can be 0 (zero) to disable buffering.

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

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

Атрибуты

Исключения

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

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

Комментарии

Примечание

В Visual Basic и C#этот метод можно вызвать как метод экземпляра для любого объекта типа Stream.In Visual Basic and C#, you can call this method as an instance method on any object of type Stream. При вызове метода для экземпляра следует опускать первый параметр.When you use instance method syntax to call this method, omit the first parameter. Дополнительные сведения см. в разделе методы расширения (Visual Basic) или методы расширенияC# (руководством по программированию).For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Этот метод используется для указания размера буфера при преобразовании потока.You use this method to specify a buffer size when converting the stream. Чтобы использовать размер буфера по умолчанию 16 384 байт, используйте перегрузку AsStreamForRead(IInputStream).To use the default buffer size of 16,384 bytes, use the AsStreamForRead(IInputStream) overload.

В большинстве случаев буферизация повышает производительность операций потока.In most situations, buffering improves the performance of stream operations. Можно отключить буферизацию, установив bufferSize равным нулю, но это следует делать только в том случае, если вы уверены, что отключение буферизации подходит для конкретной ситуации.You can disable buffering by setting bufferSize to zero, but you should do this only when you are sure that disabling buffering is appropriate for your situation.

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