Stream Stream Stream Stream Class

Definição

Fornece uma exibição genérica de uma sequência de bytes.Provides a generic view of a sequence of bytes. Esta é uma classe abstrata.This is an abstract class.

public ref class Stream abstract : MarshalByRefObject, IDisposable
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public abstract class Stream : MarshalByRefObject, IDisposable
type Stream = class
    inherit MarshalByRefObject
    interface IDisposable
Public MustInherit Class Stream
Inherits MarshalByRefObject
Implements IDisposable
Herança
Derivado
Atributos
Implementações

Exemplos

O exemplo a seguir demonstra como usar dois FileStream objetos para copiar os arquivos de forma assíncrona de um diretório para outro diretório.The following example demonstrates how to use two FileStream objects to asynchronously copy the files from one directory to another directory. O FileStream classe deriva de Stream classe.The FileStream class derives from the Stream class. Observe que o manipulador de eventos Click para o controle Button está marcado com o modificador async, pois ele chama um método assíncrono.Notice that the Click event handler for the Button control is marked with the async modifier because it calls an asynchronous method.

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.Stream is the abstract base class of all streams. Um fluxo é uma abstração de uma sequência de bytes, como um arquivo, um dispositivo de arquivos entrada/saída, um pipe de comunicação de inter- processo, ou um soquete TCP/IP.A stream is an abstraction of a sequence of bytes, such as a file, an input/output device, an inter-process communication pipe, or a TCP/IP socket. O Stream classe e suas classes derivadas fornecem uma visão genérica desses tipos diferentes de entrada e saída e isolando o programador de detalhes específicos do sistema operacional e dispositivos subjacentes.The Stream class and its derived classes provide a generic view of these different types of input and output, and isolate the programmer from the specific details of the operating system and the underlying devices.

Fluxos envolvem estas três operações fundamentais:Streams involve three fundamental operations:

  • Você pode ler de fluxos.You can read from streams. Leitura é a transferência de dados de um fluxo em uma estrutura de dados, como uma matriz de bytes.Reading is the transfer of data from a stream into a data structure, such as an array of bytes.

  • Você pode gravar em fluxos.You can write to streams. A gravação é a transferência de dados de uma estrutura de dados em um fluxo.Writing is the transfer of data from a data structure into a stream.

  • Fluxos podem suportar busca.Streams can support seeking. Buscando refere-se a consulta e modificação da posição atual dentro de um fluxo.Seeking refers to querying and modifying the current position within a stream. Busca de recurso depende do tipo de repositório de backup tem um fluxo.Seek capability depends on the kind of backing store a stream has. Por exemplo, fluxos de rede não têm nenhum conceito unificado de uma posição atual e, portanto, normalmente não dá suporte à busca.For example, network streams have no unified concept of a current position, and therefore typically do not support seeking.

Alguns dos mais comumente usados fluxos que herdam de Stream estão FileStream, e MemoryStream.Some of the more commonly used streams that inherit from Stream are FileStream, and MemoryStream.

Dependendo da fonte de dados subjacente ou repositório, os fluxos podem suportar apenas alguns desses recursos.Depending on the underlying data source or repository, streams might support only some of these capabilities. Você pode consultar um fluxo para seus recursos usando o CanRead, CanWrite, e CanSeek propriedades do Stream classe.You can query a stream for its capabilities by using the CanRead, CanWrite, and CanSeek properties of the Stream class.

O Read e Write métodos ler e gravar dados em uma variedade de formatos.The Read and Write methods read and write data in a variety of formats. Para fluxos que dá suporte à busca, use o Seek e SetLength métodos e as Position e Length propriedades para consultar e modificar a posição atual e o comprimento de um fluxo.For streams that support seeking, use the Seek and SetLength methods and the Position and Length properties to query and modify the current position and length of a stream.

Esse tipo implementa o IDisposable interface.This type implements the IDisposable interface. Quando você terminar de usar o tipo, você deve descartá-lo diretamente ou indiretamente.When you have finished using the type, you should dispose of it either directly or indirectly. Para descartar o tipo diretamente, chame seu Dispose método em um try / catch bloco.To dispose of the type directly, call its Dispose method in a try/catch block. Para descartá-los indiretamente, usar uma construção de linguagem, como using (em c#) ou Using (no Visual Basic).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Para obter mais informações, consulte a seção "Usando um objeto que implementa IDisposable" o IDisposable tópico da interface.For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Descartando uma Stream objeto libera todos os dados armazenados em buffer e, essencialmente, chama o Flush método para você.Disposing a Stream object flushes any buffered data, and essentially calls the Flush method for you. Dispose também libera recursos do sistema operacional, como identificadores de arquivos, conexões de rede ou memória usada para qualquer armazenamento em buffer interno.Dispose also releases operating system resources such as file handles, network connections, or memory used for any internal buffering. O BufferedStream classe fornece a capacidade de encapsular um fluxo em buffer em torno de outro fluxo para melhorar a leitura e desempenho de gravação.The BufferedStream class provides the capability of wrapping a buffered stream around another stream in order to improve read and write performance.

Começando com o .NET Framework 4.5.NET Framework 4.5, o Stream classe inclui métodos assíncronos para simplificar operações assíncronas.Starting with the .NET Framework 4.5.NET Framework 4.5, the Stream class includes async methods to simplify asynchronous operations. Contém um método assíncrono Async em seu nome, como ReadAsync, WriteAsync, CopyToAsync, e FlushAsync.An async method contains Async in its name, such as ReadAsync, WriteAsync, CopyToAsync, and FlushAsync. Esses métodos permitem que você execute operações de e/s intensivo de recursos sem bloquear o thread principal.These methods enable you to perform resource-intensive I/O operations without blocking the main thread. Essa consideração sobre o desempenho é particularmente importante em um aplicativo Windows Store 8.xWindows 8.x Store ou área de trabalhodesktop em que uma operação demorada de fluxo pode bloquear o thread de interface do usuário e fazer seu aplicativo parecer como se não estivesse funcionando.This performance consideration is particularly important in a Windows Store 8.xWindows 8.x Store app or área de trabalhodesktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. Os métodos assíncronos são usados em conjunto com o async e await palavras-chave no Visual Basic e c#.The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.

Quando usado em uma Windows Store 8.xWindows 8.x Store aplicativo, Stream inclui dois métodos de extensão: AsInputStream e AsOutputStream.When used in a Windows Store 8.xWindows 8.x Store app, Stream includes two extension methods: AsInputStream and AsOutputStream. Esses métodos convertem uma Stream objeto em um fluxo no Tempo de Execução do WindowsWindows Runtime.These methods convert a Stream object to a stream in the Tempo de Execução do WindowsWindows Runtime. Você também pode converter um fluxo na Tempo de Execução do WindowsWindows Runtime para um Stream objeto usando o AsStreamForRead e AsStreamForWrite métodos.You can also convert a stream in the Tempo de Execução do WindowsWindows Runtime to a Stream object by using the AsStreamForRead and AsStreamForWrite methods. Para obter mais informações, confira Como: Fazer a conversão entre fluxos do .NET Framework e fluxos do Windows RuntimeFor more information, see How to: Convert Between .NET Framework Streams and Windows Runtime Streams

Algumas implementações de stream executam armazenamento em buffer local dos dados subjacentes para melhorar o desempenho.Some stream implementations perform local buffering of the underlying data to improve performance. Para esses fluxos, você pode usar o Flush ou FlushAsync método para limpar buffers internos e certifique-se de que todos os dados foram gravados para o repositório ou da fonte de dados subjacente.For such streams, you can use the Flush or FlushAsync method to clear any internal buffers and ensure that all data has been written to the underlying data source or repository.

Se você precisar de um fluxo com nenhum repositório de backup (também conhecido como um depósito de bits), use o Null campo a recuperar uma instância de um fluxo que foi projetado para essa finalidade.If you need a stream with no backing store (also known as a bit bucket), use the Null field to retrieve an instance of a stream that is designed for this purpose.

Notas aos Herdeiros

Quando você implementa uma classe derivada de Stream, você deve fornecer implementações para o Read(Byte[], Int32, Int32) e Write(Byte[], Int32, Int32) métodos.When you implement a derived class of Stream, you must provide implementations for the Read(Byte[], Int32, Int32) and Write(Byte[], Int32, Int32) methods. Os métodos assíncronos ReadAsync(Byte[], Int32, Int32), WriteAsync(Byte[], Int32, Int32), e CopyToAsync(Stream) usam os métodos síncronos Read(Byte[], Int32, Int32) e Write(Byte[], Int32, Int32) em suas implementações.The asynchronous methods ReadAsync(Byte[], Int32, Int32), WriteAsync(Byte[], Int32, Int32), and CopyToAsync(Stream) use the synchronous methods Read(Byte[], Int32, Int32) and Write(Byte[], Int32, Int32) in their implementations. Portanto, suas implementações de Read(Byte[], Int32, Int32) e Write(Byte[], Int32, Int32) funcionarão corretamente com os métodos assíncronos.Therefore, your implementations of Read(Byte[], Int32, Int32) and Write(Byte[], Int32, Int32) will work correctly with the asynchronous methods. 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).The default implementations of ReadByte() and WriteByte(Byte) create a new single-element byte array, and then call your implementations of Read(Byte[], Int32, Int32) and Write(Byte[], Int32, Int32). Quando você derivar de Stream, recomendamos que você substitua esses métodos para acessar o buffer interno, se você tiver um, para melhorar substancialmente o desempenho.When you derive from Stream, we recommend that you override these methods to access your internal buffer, if you have one, for substantially better performance. Você também deve fornecer implementações CanRead, CanSeek, CanWrite, Flush(), Length, Position, Seek(Int64, SeekOrigin), e SetLength(Int64).You must also provide implementations of CanRead, CanSeek, CanWrite, Flush(), Length, Position, Seek(Int64, SeekOrigin), and SetLength(Int64).

Não substituir a Close() método, em vez disso, colocar todos os as Stream lógica de limpeza no Dispose(Boolean) método.Do not override the Close() method, instead, put all the Stream cleanup logic in the Dispose(Boolean) method. Para obter mais informações, consulte implementando um método Dispose.For more information, see Implementing a Dispose Method.

Construtores

Stream() Stream() Stream() Stream()

Inicializa uma nova instância da classe Stream.Initializes a new instance of the Stream class.

Campos

Null Null Null Null

Um Stream sem repositório de backup.A Stream with no backing store.

Propriedades

CanRead CanRead CanRead CanRead

Quando substituído em uma classe derivada, obtém um valor que indica se o fluxo atual dá suporte à leitura.When overridden in a derived class, gets a value indicating whether the current stream supports reading.

CanSeek CanSeek CanSeek CanSeek

Quando substituído em uma classe derivada, obtém um valor que indica se o fluxo atual dá suporte à busca.When overridden in a derived class, gets a value indicating whether the current stream supports seeking.

CanTimeout CanTimeout CanTimeout CanTimeout

Obtém um valor que determina se o fluxo atual pode atingir o tempo limite.Gets a value that determines whether the current stream can time out.

CanWrite CanWrite CanWrite CanWrite

Quando substituído em uma classe derivada, obtém um valor que indica se o fluxo atual dá suporte à gravação.When overridden in a derived class, gets a value indicating whether the current stream supports writing.

Length Length Length Length

Quando substituído em uma classe derivada, obtém o tamanho em bytes do fluxo.When overridden in a derived class, gets the length in bytes of the stream.

Position Position Position Position

Quando substituído em uma classe derivada, obtém ou define a posição dentro do fluxo atual.When overridden in a derived class, gets or sets the position within the current stream.

ReadTimeout ReadTimeout ReadTimeout ReadTimeout

Obtém ou define um valor, em milissegundos, que determina por quanto tempo o fluxo tentará realizar a leitura antes do tempo limite.Gets or sets a value, in milliseconds, that determines how long the stream will attempt to read before timing out.

WriteTimeout WriteTimeout WriteTimeout WriteTimeout

Obtém ou define um valor, em milissegundos, que determina por quanto tempo o fluxo tentará realizar a gravação antes do tempo limite.Gets or sets a value, in milliseconds, that determines how long the stream will attempt to write before timing out.

Métodos

BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)

Inicia uma operação de leitura assíncrona.Begins an asynchronous read operation. (Considere o uso de ReadAsync(Byte[], Int32, Int32) em seu lugar.)(Consider using ReadAsync(Byte[], Int32, Int32) instead.)

BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)

Inicia uma operação de gravação assíncrona.Begins an asynchronous write operation. (Considere o uso de WriteAsync(Byte[], Int32, Int32) em seu lugar.)(Consider using WriteAsync(Byte[], Int32, Int32) instead.)

Close() Close() Close() Close()

Fecha o fluxo atual e libera todos os recursos (como soquetes e identificadores de arquivos) associados ao fluxo atual.Closes the current stream and releases any resources (such as sockets and file handles) associated with the current stream. Em vez de chamar esse método, verifique se o fluxo é descartado corretamente.Instead of calling this method, ensure that the stream is properly disposed.

CopyTo(Stream) CopyTo(Stream) CopyTo(Stream) CopyTo(Stream)

Lê os bytes do fluxo atual e os grava em outro fluxo.Reads the bytes from the current stream and writes them to another stream.

CopyTo(Stream, Int32) CopyTo(Stream, Int32) CopyTo(Stream, Int32) CopyTo(Stream, Int32)

Lê os bytes do fluxo atual e os grava em outro fluxo usando um tamanho do buffer especificado.Reads the bytes from the current stream and writes them to another stream, using a specified buffer size.

CopyToAsync(Stream) CopyToAsync(Stream) CopyToAsync(Stream) CopyToAsync(Stream)

Lê de forma assíncrona os bytes do fluxo atual e os grava em outro fluxo.Asynchronously reads the bytes from the current stream and writes them to another stream.

CopyToAsync(Stream, CancellationToken) CopyToAsync(Stream, CancellationToken) CopyToAsync(Stream, CancellationToken) CopyToAsync(Stream, CancellationToken)

Lê de forma assíncrona os bytes do fluxo atual e os grava em outro fluxo usando um token de cancelamento especificado.Asynchronously reads the bytes from the current stream and writes them to another stream, using a specified cancellation token.

CopyToAsync(Stream, Int32) CopyToAsync(Stream, Int32) CopyToAsync(Stream, Int32) CopyToAsync(Stream, Int32)

Lê de maneira assíncrona os bytes do fluxo atual e os grava em outro fluxo usando um tamanho do buffer especificado.Asynchronously reads the bytes from the current stream and writes them to another stream, using a specified buffer size.

CopyToAsync(Stream, Int32, CancellationToken) CopyToAsync(Stream, Int32, CancellationToken) CopyToAsync(Stream, Int32, CancellationToken) CopyToAsync(Stream, Int32, CancellationToken)

Lê de forma assíncrona os bytes do fluxo atual e os grava em outro fluxo usando um tamanho do buffer especificado e um token de cancelamento.Asynchronously reads the bytes from the current stream and writes them to another stream, using a specified buffer size and cancellation token.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
CreateWaitHandle() CreateWaitHandle() CreateWaitHandle() CreateWaitHandle()

Aloca um objeto WaitHandle.Allocates a WaitHandle object.

Dispose() Dispose() Dispose() Dispose()

Libera todos os recursos usados pelo Stream.Releases all resources used by the Stream.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera os recursos não gerenciados usados pelo Stream e opcionalmente libera os recursos gerenciados.Releases the unmanaged resources used by the Stream and optionally releases the managed resources.

DisposeAsync() DisposeAsync() DisposeAsync() DisposeAsync()

Libera de forma assíncrona os recursos não gerenciados usados pelo Stream.Asynchronously releases the unmanaged resources used by the Stream.

EndRead(IAsyncResult) EndRead(IAsyncResult) EndRead(IAsyncResult) EndRead(IAsyncResult)

Espera a leitura assíncrona pendente ser concluída.Waits for the pending asynchronous read to complete. (Considere o uso de ReadAsync(Byte[], Int32, Int32) em seu lugar.)(Consider using ReadAsync(Byte[], Int32, Int32) instead.)

EndWrite(IAsyncResult) EndWrite(IAsyncResult) EndWrite(IAsyncResult) EndWrite(IAsyncResult)

Encerra uma operação de gravação assíncrona.Ends an asynchronous write operation. (Considere o uso de WriteAsync(Byte[], Int32, Int32) em seu lugar.)(Consider using WriteAsync(Byte[], Int32, Int32) instead.)

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Flush() Flush() Flush() Flush()

Quando é substituído em uma classe derivada, limpa todos os buffers nesse fluxo e faz com que todos os dados armazenados em buffer sejam gravados no dispositivo subjacente.When overridden in a derived class, clears all buffers for this stream and causes any buffered data to be written to the underlying device.

FlushAsync() FlushAsync() FlushAsync() FlushAsync()

Limpa de forma assíncrona todos os buffers nesse fluxo e faz com que os dados armazenados em buffer sejam gravados no dispositivo subjacente.Asynchronously clears all buffers for this stream and causes any buffered data to be written to the underlying device.

FlushAsync(CancellationToken) FlushAsync(CancellationToken) FlushAsync(CancellationToken) FlushAsync(CancellationToken)

Limpa todos os buffers nesse fluxo de forma assíncrona, faz com que os dados armazenados em buffer sejam gravados no dispositivo subjacente e monitora as solicitações de cancelamento.Asynchronously clears all buffers for this stream, causes any buffered data to be written to the underlying device, and monitors cancellation requests.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
ObjectInvariant() ObjectInvariant() ObjectInvariant() ObjectInvariant()

Oferece suporte a um Contract.Provides support for a Contract.

Read(Byte[], Int32, Int32) Read(Byte[], Int32, Int32) Read(Byte[], Int32, Int32) Read(Byte[], Int32, Int32)

Quando for substituído em uma classe derivada, lê uma sequência de bytes do fluxo atual e avança a posição dentro do fluxo até o número de bytes lidos.When overridden in a derived class, reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read.

Read(Span<Byte>) Read(Span<Byte>) Read(Span<Byte>) Read(Span<Byte>)

Quando for substituído em uma classe derivada, lê uma sequência de bytes do fluxo atual e avança a posição dentro do fluxo até o número de bytes lidos.When overridden in a derived class, reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read.

ReadAsync(Byte[], Int32, Int32) ReadAsync(Byte[], Int32, Int32) ReadAsync(Byte[], Int32, Int32) ReadAsync(Byte[], Int32, Int32)

Lê uma sequência de bytes do fluxo atual de forma assíncrona e avança a posição no fluxo até o número de bytes lidos.Asynchronously reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read.

ReadAsync(Byte[], Int32, Int32, CancellationToken) ReadAsync(Byte[], Int32, Int32, CancellationToken) ReadAsync(Byte[], Int32, Int32, CancellationToken) ReadAsync(Byte[], Int32, Int32, CancellationToken)

Lê de forma assíncrona uma sequência de bytes do fluxo atual, avança a posição no fluxo até o número de bytes lidos e monitora as solicitações de cancelamento.Asynchronously reads a sequence of bytes from the current stream, advances the position within the stream by the number of bytes read, and monitors cancellation requests.

ReadAsync(Memory<Byte>, CancellationToken) ReadAsync(Memory<Byte>, CancellationToken) ReadAsync(Memory<Byte>, CancellationToken) ReadAsync(Memory<Byte>, CancellationToken)

Lê de forma assíncrona uma sequência de bytes do fluxo atual, avança a posição no fluxo até o número de bytes lidos e monitora as solicitações de cancelamento.Asynchronously reads a sequence of bytes from the current stream, advances the position within the stream by the number of bytes read, and monitors cancellation requests.

ReadByte() ReadByte() ReadByte() ReadByte()

Lê um byte do fluxo e avança a posição no fluxo em um byte ou retorna -1 caso esteja no final do fluxo.Reads a byte from the stream and advances the position within the stream by one byte, or returns -1 if at the end of the stream.

Seek(Int64, SeekOrigin) Seek(Int64, SeekOrigin) Seek(Int64, SeekOrigin) Seek(Int64, SeekOrigin)

Quando substituído em uma classe derivada, define a posição dentro do fluxo atual.When overridden in a derived class, sets the position within the current stream.

SetLength(Int64) SetLength(Int64) SetLength(Int64) SetLength(Int64)

Quando substituído em uma classe derivada, define o tamanho do fluxo atual.When overridden in a derived class, sets the length of the current stream.

Synchronized(Stream) Synchronized(Stream) Synchronized(Stream) Synchronized(Stream)

Cria um wrapper thread-safe (sincronizado) em torno do objeto Stream especificado.Creates a thread-safe (synchronized) wrapper around the specified Stream object.

ToString() ToString() ToString() ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Inherited from Object)
Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32)

Quando for substituído em uma classe derivada, grava uma sequência de bytes no fluxo atual e avança a posição atual dentro desse fluxo até o número de bytes gravados.When overridden in a derived class, writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>)

Quando for substituído em uma classe derivada, grava uma sequência de bytes no fluxo atual e avança a posição atual dentro desse fluxo até o número de bytes gravados.When overridden in a derived class, writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

WriteAsync(Byte[], Int32, Int32) WriteAsync(Byte[], Int32, Int32) WriteAsync(Byte[], Int32, Int32) WriteAsync(Byte[], Int32, Int32)

Grava assincronamente uma sequência de bytes no fluxo atual e avança a posição atual dentro desse fluxo no número de bytes gravados.Asynchronously writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

WriteAsync(Byte[], Int32, Int32, CancellationToken) WriteAsync(Byte[], Int32, Int32, CancellationToken) WriteAsync(Byte[], Int32, Int32, CancellationToken) WriteAsync(Byte[], Int32, Int32, CancellationToken)

Grava uma sequência de bytes no fluxo atual assincronamente, avança a posição atual dentro desse fluxo pelo número de bytes gravados e monitora as solicitações de cancelamento.Asynchronously writes a sequence of bytes to the current stream, advances the current position within this stream by the number of bytes written, and monitors cancellation requests.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken) WriteAsync(ReadOnlyMemory<Byte>, CancellationToken) WriteAsync(ReadOnlyMemory<Byte>, CancellationToken) WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Grava uma sequência de bytes no fluxo atual assincronamente, avança a posição atual dentro desse fluxo pelo número de bytes gravados e monitora as solicitações de cancelamento.Asynchronously writes a sequence of bytes to the current stream, advances the current position within this stream by the number of bytes written, and monitors cancellation requests.

WriteByte(Byte) WriteByte(Byte) WriteByte(Byte) WriteByte(Byte)

Grava um byte na posição atual no fluxo e avança a posição dentro no fluxo em um byte.Writes a byte to the current position in the stream and advances the position within the stream by one byte.

Implantações explícitas de interface

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

Libera todos os recursos usados pelo Stream.Releases all resources used by the Stream.

Métodos de Extensão

AsInputStream(Stream) AsInputStream(Stream) AsInputStream(Stream) AsInputStream(Stream)

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

AsOutputStream(Stream) AsOutputStream(Stream) AsOutputStream(Stream) AsOutputStream(Stream)

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

AsRandomAccessStream(Stream) AsRandomAccessStream(Stream) AsRandomAccessStream(Stream) AsRandomAccessStream(Stream)

Converte o fluxo especificado em um fluxo de acesso aleatório.Converts the specified stream to a random access stream.

Aplica-se a

Veja também