WindowsRuntimeStreamExtensions.AsStreamForRead Método

Definição

Sobrecargas

AsStreamForRead(IInputStream)

Converte um fluxo de entrada no Windows Runtime em um fluxo gerenciado no .NET para Aplicativos da Windows Store.Converts an input stream in the Windows Runtime to a managed stream in the .NET for Windows Store apps.

AsStreamForRead(IInputStream, Int32)

Converte um fluxo de entrada no Windows Runtime em um fluxo gerenciado no .NET para aplicativos da Windows 8.x Store usando o tamanho do buffer especificado.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)

Importante

Esta API não está em conformidade com CLS.

Converte um fluxo de entrada no Windows Runtime em um fluxo gerenciado no .NET para Aplicativos da Windows Store.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

Parâmetros

windowsRuntimeStream
IInputStream

O objeto IInputStream do Windows Runtime a ser convertido.The Windows Runtime IInputStream object to convert.

Retornos

O fluxo convertido.The converted stream.

Atributos

Exceções

windowsRuntimeStream é null.windowsRuntimeStream is null.

Exemplos

O exemplo a seguir mostra como usar os métodos AsStreamForWrite e AsStreamForRead para converter um fluxo gerenciado de e para um fluxo no Windows Runtime.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

Este é o código XAML associado ao exemplo anterior.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>

Comentários

Observação

Em Visual Basic e C#, você pode chamar esse método como um método de instância em qualquer objeto do tipo Stream.In Visual Basic and C#, you can call this method as an instance method on any object of type Stream. Quando você usar a sintaxe de método de instância para chamar esse método, omita o primeiro parâmetro.When you use instance method syntax to call this method, omit the first parameter. Para obter mais informações, consulte métodos de extensão (Visual Basic) ou métodosC# de extensão (guia de programação).For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Um tamanho de buffer padrão de 16.384 bytes é usado ao converter o fluxo.A default buffer size of 16,384 bytes is used when converting the stream. Para especificar um tamanho de buffer diferente, use a sobrecarga de AsStreamForRead(IInputStream, Int32).To specify a different buffer size, use the AsStreamForRead(IInputStream, Int32) overload.

AsStreamForRead(IInputStream, Int32)

Importante

Esta API não está em conformidade com CLS.

Converte um fluxo de entrada no Windows Runtime em um fluxo gerenciado no .NET para aplicativos da Windows 8.x Store usando o tamanho do buffer especificado.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

Parâmetros

windowsRuntimeStream
IInputStream

O objeto do Windows Runtime a ser convertido.The Windows Runtime object to convert.

bufferSize
Int32

O tamanho do buffer, em bytes.The size, in bytes, of the buffer. Este valor não pode ser negativo, mas pode ser 0 (zero) para desabilitar o buffering.This value cannot be negative, but it can be 0 (zero) to disable buffering.

Retornos

O fluxo convertido.The converted stream.

Atributos

Exceções

windowsRuntimeStream é null.windowsRuntimeStream is null.

bufferSize é negativo.bufferSize is negative.

Comentários

Observação

Em Visual Basic e C#, você pode chamar esse método como um método de instância em qualquer objeto do tipo Stream.In Visual Basic and C#, you can call this method as an instance method on any object of type Stream. Quando você usar a sintaxe de método de instância para chamar esse método, omita o primeiro parâmetro.When you use instance method syntax to call this method, omit the first parameter. Para obter mais informações, consulte métodos de extensão (Visual Basic) ou métodosC# de extensão (guia de programação).For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Você usa esse método para especificar um tamanho de buffer ao converter o fluxo.You use this method to specify a buffer size when converting the stream. Para usar o tamanho de buffer padrão de 16.384 bytes, use a sobrecarga de AsStreamForRead(IInputStream).To use the default buffer size of 16,384 bytes, use the AsStreamForRead(IInputStream) overload.

Na maioria das situações, o armazenamento em buffer melhora o desempenho das operações de fluxo.In most situations, buffering improves the performance of stream operations. Você pode desabilitar o armazenamento em buffer definindo bufferSize como zero, mas você deve fazer isso somente quando tiver certeza de que a desabilitação do buffer é apropriada para sua situação.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.

Aplica-se a