Stream Classe

Definição

public ref class Stream abstract : IDisposable

public ref class Stream abstract : MarshalByRefObject, IAsyncDisposable, IDisposable

public ref class Stream abstract : MarshalByRefObject, IDisposable

public abstract class Stream : IDisposable

public abstract class Stream : MarshalByRefObject, IAsyncDisposable, IDisposable

public abstract class Stream : MarshalByRefObject, IDisposable

[System.Serializable]
public abstract class Stream : MarshalByRefObject, IDisposable

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Stream : MarshalByRefObject, IDisposable

type Stream = class
    interface IDisposable

type Stream = class
    inherit MarshalByRefObject
    interface IAsyncDisposable
    interface IDisposable

type Stream = class
    inherit MarshalByRefObject
    interface IDisposable

[<System.Serializable>]
type Stream = class
    inherit MarshalByRefObject
    interface IDisposable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Stream = class
    inherit MarshalByRefObject
    interface IDisposable

Public MustInherit Class Stream
Implements IDisposable

Public MustInherit Class Stream
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDisposable

Public MustInherit Class Stream
Inherits MarshalByRefObject
Implements IDisposable

Herança

Object

Stream

Herança

Object

MarshalByRefObject

Stream

Derivado

Microsoft.Extensions.AI.HostedFileDownloadStream

Microsoft.JScript.COMCharStream

System.Data.OracleClient.OracleBFile

System.Data.OracleClient.OracleLob

System.Data.SqlTypes.SqlFileStream

Mais…

Atributos

SerializableAttribute ComVisibleAttribute

Implementações

IDisposable IAsyncDisposable

Exemplos

O exemplo a seguir demonstra como usar dois FileStream objetos para copiar de forma assíncrona os arquivos de um diretório para outro diretório. A FileStream classe deriva da Stream classe. Observe que o Click manipulador de eventos do Button controle está marcado com o async modificador porque ele chama um método assíncrono.

using System;
using System.Threading.Tasks;
using System.Windows;
using System.IO;

namespace WpfApplication
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }

        private async void Button_Click(object sender, RoutedEventArgs e)
        {
            string StartDirectory = @"c:\Users\exampleuser\start";
            string EndDirectory = @"c:\Users\exampleuser\end";

            foreach (string filename in Directory.EnumerateFiles(StartDirectory))
            {
                using (FileStream SourceStream = File.Open(filename, FileMode.Open))
                {
                    using (FileStream DestinationStream = File.Create(EndDirectory + filename.Substring(filename.LastIndexOf('\\'))))
                    {
                        await SourceStream.CopyToAsync(DestinationStream);
                    }
                }
            }
        }
    }
}

Imports System.IO

Class MainWindow

    Private Async Sub Button_Click(sender As Object, e As RoutedEventArgs)
        Dim StartDirectory As String = "c:\Users\exampleuser\start"
        Dim EndDirectory As String = "c:\Users\exampleuser\end"

        For Each filename As String In Directory.EnumerateFiles(StartDirectory)
            Using SourceStream As FileStream = File.Open(filename, FileMode.Open)
                Using DestinationStream As FileStream = File.Create(EndDirectory + filename.Substring(filename.LastIndexOf("\"c)))
                    Await SourceStream.CopyToAsync(DestinationStream)
                End Using

            End Using
        Next
    End Sub

End Class

Comentários

Stream é a classe base abstrata de todos os fluxos. Um fluxo é uma abstração de uma sequência de bytes, como um arquivo, um dispositivo de entrada/saída, um pipe de comunicação entre processos ou um soquete TCP/IP. A Stream classe e suas classes derivadas fornecem uma exibição genérica desses diferentes tipos de entrada e saída e isolam o programador dos detalhes específicos do sistema operacional e dos dispositivos subjacentes.

Os fluxos envolvem três operações fundamentais:

• Você pode ler de fluxos. A leitura é a transferência de dados de um fluxo para uma estrutura de dados, como uma matriz de bytes.

• Você pode gravar em fluxos. Gravar é a transferência de dados de uma estrutura de dados para um fluxo.

• Os fluxos podem dar suporte à busca. A busca refere-se à consulta e à modificação da posição atual em um fluxo. A funcionalidade seek depende do tipo de repositório de backup que um fluxo tem. Por exemplo, os fluxos de rede não têm nenhum conceito unificado de uma posição atual e, portanto, normalmente não dão suporte à busca.

Alguns dos fluxos mais usados que herdam Stream são FileStream, e MemoryStream.

Dependendo da fonte de dados ou repositório subjacente, os fluxos podem dar suporte apenas a alguns desses recursos. Você pode consultar um fluxo para seus recursos usando as propriedades e CanSeek as CanReadCanWritepropriedades da Stream classe.

Os Read métodos e Write os métodos leem e gravam dados em uma variedade de formatos. Para fluxos que dão suporte à busca, use os Seek métodos e SetLength os métodos e Length as Position propriedades para consultar e modificar a posição e o comprimento atuais de um fluxo.

Esse tipo implementa a IDisposable interface. Quando terminar de usar o tipo, você deverá descartá-lo direta ou indiretamente. Para descartar o tipo diretamente, chame o método Dispose dele em um bloco try/catch. Para descartá-lo indiretamente, use um constructo de linguagem como using (em C#) ou Using (no Visual Basic). Para obter mais informações, consulte a seção "Usando um objeto que implementa idisposable" no tópico da IDisposable interface.

Descartar um Stream objeto libera todos os dados em buffer e, essencialmente, chama o Flush método para você. Dispose também libera recursos do sistema operacional, como identificadores de arquivo, conexões de rede ou memória usada para qualquer buffer interno. A BufferedStream classe fornece a capacidade de encapsular um fluxo em buffer em torno de outro fluxo, a fim de melhorar o desempenho de leitura e gravação.

A partir do .NET Framework 4.5, a Stream classe inclui métodos assíncronos para simplificar operações assíncronas. Um método assíncrono contém Async em seu nome, como ReadAsync, , WriteAsynce CopyToAsyncFlushAsync. Esses métodos permitem que você execute operações de E/S com uso intensivo de recursos sem bloquear o thread principal. Essa consideração de desempenho é particularmente importante em um aplicativo da Windows 8.x Store ou aplicativo da área de trabalho em que uma operação de fluxo demorada pode bloquear o thread da interface do usuário e fazer seu aplicativo aparecer como se ele não estivesse funcionando. Os métodos assíncronos são usados em conjunto com as palavras-chave async e await em Visual Basic e C#.

Quando usado em um aplicativo da Windows 8.x Store, Stream inclui dois métodos de extensão: AsInputStream e AsOutputStream. Esses métodos convertem um Stream objeto em um fluxo no Windows Runtime. Você também pode converter um fluxo no Windows Runtime em um Stream objeto usando os métodos e AsStreamForWrite os AsStreamForRead métodos. Para obter mais informações, consulte Como converter entre fluxos do .NET Framework e fluxos do Windows Runtime

Algumas implementações de fluxo executam o buffer local dos dados subjacentes para melhorar o desempenho. Para esses fluxos, você pode usar o método ou FlushAsync o Flush método para limpar os buffers internos e garantir que todos os dados foram gravados na fonte de dados ou repositório subjacente.

Se você precisar de um fluxo sem repositório de backup (também conhecido como bucket de bits), use o Null campo para recuperar uma instância de um fluxo projetado para essa finalidade.

Notas aos Implementadores

Ao implementar uma classe derivada deStream, você deve fornecer implementações para os métodos e Write(Byte[], Int32, Int32) os Read(Byte[], Int32, Int32) métodos. Os métodos ReadAsync(Byte[], Int32, Int32)assíncronos , WriteAsync(Byte[], Int32, Int32)e CopyToAsync(Stream) usar os métodos Read(Byte[], Int32, Int32) síncronos e Write(Byte[], Int32, Int32) em suas implementações. Portanto, suas implementações e Read(Byte[], Int32, Int32)Write(Byte[], Int32, Int32) funcionarão corretamente com os métodos assíncronos. As implementações padrão de ReadByte() e WriteByte(Byte) criar uma nova matriz de bytes de elemento único e, em seguida, chamar suas implementações de Read(Byte[], Int32, Int32) e Write(Byte[], Int32, Int32). Quando você deriva de Stream, recomendamos que você substitua esses métodos para acessar seu buffer interno, se você tiver um, para um desempenho substancialmente melhor. Você também deve fornecer implementações de CanRead, , CanWriteCanSeek, , Flush(), Length, Position, Seek(Int64, SeekOrigin)e SetLength(Int64).

Não substitua o Close() método, em vez disso, coloque toda a lógica de Stream limpeza no Dispose(Boolean) método. Para obter mais informações, consulte Implementando um método Dispose.

Confira também

• FileStream
• MemoryStream
• BufferedStream
• E/S de arquivo e de fluxo
• Como converter entre fluxos do .NET Framework e fluxos do Windows Runtime