FileStream FileStream FileStream FileStream Class

Definição

Fornece um Stream para um arquivo, dando suporte a operações de leitura e gravação síncronas e assíncronas.Provides a Stream for a file, supporting both synchronous and asynchronous read and write operations.

public ref class FileStream : System::IO::Stream
[System.Runtime.InteropServices.ComVisible(true)]
public class FileStream : System.IO.Stream
type FileStream = class
    inherit Stream
Public Class FileStream
Inherits Stream
Herança
Atributos

Exemplos

O exemplo a seguir demonstra algumas do FileStream construtores.The following example demonstrates some of the FileStream constructors.

using namespace System;
using namespace System::IO;
using namespace System::Text;

void AddText( FileStream^ fs, String^ value )
{
   array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes( value );
   fs->Write( info, 0, info->Length );
}

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Delete the file if it exists.
   if ( File::Exists( path ) )
   {
      File::Delete( path );
   }

   //Create the file.
   {
      FileStream^ fs = File::Create( path );
      try
      {
         AddText( fs, "This is some text" );
         AddText( fs, "This is some more text," );
         AddText( fs, "\r\nand this is on a new line" );
         AddText( fs, "\r\n\r\nThe following is a subset of characters:\r\n" );
         for ( int i = 1; i < 120; i++ )
         {
            AddText( fs, Convert::ToChar( i ).ToString() );
            
            //Split the output at every 10th character.
            if ( Math::IEEERemainder( Convert::ToDouble( i ), 10 ) == 0 )
            {
               AddText( fs, "\r\n" );
            }
         }
      }
      finally
      {
         if ( fs )
            delete (IDisposable^)fs;
      }
   }
   
   //Open the stream and read it back.
   {
      FileStream^ fs = File::OpenRead( path );
      try
      {
         array<Byte>^b = gcnew array<Byte>(1024);
         UTF8Encoding^ temp = gcnew UTF8Encoding( true );
         while ( fs->Read( b, 0, b->Length ) > 0 )
         {
            Console::WriteLine( temp->GetString( b ) );
         }
      }
      finally
      {
         if ( fs )
            delete (IDisposable^)fs;
      }
   }
}
using System;
using System.IO;
using System.Text;

class Test
{

    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        // Delete the file if it exists.
        if (File.Exists(path))
        {
            File.Delete(path);
        }

        //Create the file.
        using (FileStream fs = File.Create(path))
        {
            AddText(fs, "This is some text");
            AddText(fs, "This is some more text,");
            AddText(fs, "\r\nand this is on a new line");
            AddText(fs, "\r\n\r\nThe following is a subset of characters:\r\n");

            for (int i=1;i < 120;i++)
            {
                AddText(fs, Convert.ToChar(i).ToString());

            }
        }

        //Open the stream and read it back.
        using (FileStream fs = File.OpenRead(path))
        {
            byte[] b = new byte[1024];
            UTF8Encoding temp = new UTF8Encoding(true);
            while (fs.Read(b,0,b.Length) > 0)
            {
                Console.WriteLine(temp.GetString(b));
            }
        }
    }

    private static void AddText(FileStream fs, string value)
    {
        byte[] info = new UTF8Encoding(true).GetBytes(value);
        fs.Write(info, 0, info.Length);
    }
}
Imports System
Imports System.IO
Imports System.Text

Public Class Test

    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"

        ' Delete the file if it exists.
        If File.Exists(path) Then
            File.Delete(path)
        End If

        'Create the file.
        Dim fs As FileStream = File.Create(path)

        AddText(fs, "This is some text")
        AddText(fs, "This is some more text,")
        AddText(fs, Environment.NewLine & "and this is on a new line")
        AddText(fs, Environment.NewLine & Environment.NewLine)
        AddText(fs, "The following is a subset of characters:" & Environment.NewLine)

        Dim i As Integer

        For i = 1 To 120
            AddText(fs, Convert.ToChar(i).ToString())

        Next

        fs.Close()

        'Open the stream and read it back.
        fs = File.OpenRead(path)
        Dim b(1024) As Byte
        Dim temp As UTF8Encoding = New UTF8Encoding(True)

        Do While fs.Read(b, 0, b.Length) > 0
            Console.WriteLine(temp.GetString(b))
        Loop

        fs.Close()
    End Sub

    Private Shared Sub AddText(ByVal fs As FileStream, ByVal value As String)
        Dim info As Byte() = New UTF8Encoding(True).GetBytes(value)
        fs.Write(info, 0, info.Length)
    End Sub
End Class

O exemplo a seguir mostra como gravar em um arquivo de forma assíncrona.The following example shows how to write to a file asynchronously. Esse código é executado em um aplicativo WPF que tem um TextBlock chamado UserInput e um botão vinculada a um manipulador de eventos Button_Click chamado.This code runs in a WPF app that has a TextBlock named UserInput and a button hooked up to a Click event handler that is named Button_Click. O caminho do arquivo precisa ser alterado para um arquivo que existe no computador.The file path needs to be changed to a file that exists on the computer.

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

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

        private async void Button_Click(object sender, RoutedEventArgs e)
        {
            UnicodeEncoding uniencoding = new UnicodeEncoding();
            string filename = @"c:\Users\exampleuser\Documents\userinputlog.txt";
           
            byte[] result = uniencoding.GetBytes(UserInput.Text);
            
            using (FileStream SourceStream = File.Open(filename, FileMode.OpenOrCreate))
            {
                SourceStream.Seek(0, SeekOrigin.End);
                await SourceStream.WriteAsync(result, 0, result.Length);
            }
        }
    }
}
Imports System.IO
Imports System.Text

Class MainWindow
    Private Async Sub Button_Click(sender As Object, e As RoutedEventArgs)
        Dim uniencoding As UnicodeEncoding = New UnicodeEncoding()
        Dim filename As String = "c:\Users\exampleuser\Documents\userinputlog.txt"

        Dim result As Byte() = uniencoding.GetBytes(UserInput.Text)

        Using SourceStream As FileStream = File.Open(filename, FileMode.OpenOrCreate)
            SourceStream.Seek(0, SeekOrigin.End)
            Await SourceStream.WriteAsync(result, 0, result.Length)
        End Using
    End Sub
End Class

Comentários

Use o FileStream classe para leitura, gravação, abrir e fechar arquivos em um sistema de arquivos e para manipular outros identificadores do sistema de operacional relacionadas ao arquivo, incluindo pipes, entrada e saída padrão.Use the FileStream class to read from, write to, open, and close files on a file system, and to manipulate other file-related operating system handles, including pipes, standard input, and standard output. Você pode usar o Read, Write, CopyTo, e Flush métodos para realizar operações síncronas, ou o ReadAsync, WriteAsync, CopyToAsync, e FlushAsync métodos para executar assíncrona operações.You can use the Read, Write, CopyTo, and Flush methods to perform synchronous operations, or the ReadAsync, WriteAsync, CopyToAsync, and FlushAsync methods to perform asynchronous operations. Use os métodos assíncronos para executar operações de arquivo de uso intensivo de recursos sem bloquear o thread principal.Use the asynchronous methods to perform resource-intensive file 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. FileStream buffers de entrada e saída para melhorar o desempenho.FileStream buffers input and output for better performance.

Importante

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.

O IsAsync propriedade detecta se o identificador de arquivo foi aberto de forma assíncrona.The IsAsync property detects whether the file handle was opened asynchronously. Especifique esse valor quando você cria uma instância das FileStream classe usando um construtor que tem um isAsync, useAsync, ou options parâmetro.You specify this value when you create an instance of the FileStream class using a constructor that has an isAsync, useAsync, or options parameter. Quando a propriedade for true, utiliza o fluxo de e/s sobreposta para executar operações de arquivo de forma assíncrona.When the property is true, the stream utilizes overlapped I/O to perform file operations asynchronously. No entanto, o IsAsync propriedade não precisa ser true para chamar o ReadAsync, WriteAsync, ou CopyToAsync método.However, the IsAsync property does not have to be true to call the ReadAsync, WriteAsync, or CopyToAsync method. Quando o IsAsync é de propriedade false e chamar a leitura assíncrona e operações de gravação, o thread de interface do usuário ainda não está bloqueado, mas a operação de e/s real é executada de forma síncrona.When the IsAsync property is false and you call the asynchronous read and write operations, the UI thread is still not blocked, but the actual I/O operation is performed synchronously.

O Seek método dá suporte ao acesso aleatório a arquivos.The Seek method supports random access to files. Seek permite que a posição de leitura/gravação a ser movido para qualquer posição dentro do arquivo.Seek allows the read/write position to be moved to any position within the file. Isso é feito com parâmetros de ponto de referência de deslocamento de bytes.This is done with byte offset reference point parameters. O deslocamento de bytes é relativo ao ponto de referência de busca, que pode ser no início, a posição atual ou o final do arquivo subjacente, conforme representado pelos membros de três a SeekOrigin enumeração.The byte offset is relative to the seek reference point, which can be the beginning, the current position, or the end of the underlying file, as represented by the three members of the SeekOrigin enumeration.

Observação

Arquivos de disco sempre oferecem suporte a acesso aleatório.Disk files always support random access. No momento da construção, o CanSeek o valor da propriedade é definido como true ou false dependendo do tipo de arquivo subjacente. Se o tipo de arquivo subjacente é FILE_TYPE_DISK, conforme definido em Winbase, o CanSeek é o valor da propriedade true.At the time of construction, the CanSeek property value is set to true or false depending on the underlying file type.If the underlying file type is FILE_TYPE_DISK, as defined in winbase.h, the CanSeek property value is true. Caso contrário, o CanSeek é o valor da propriedade false.Otherwise, the CanSeek property value is false.

Se um processo é encerrado com parte de um arquivo bloqueado ou fecha um arquivo que tenha bloqueios pendentes, o comportamento será indefinido.If a process terminates with part of a file locked or closes a file that has outstanding locks, the behavior is undefined.

Para operações de diretório e outras operações de arquivo, consulte o File, Directory, e Path classes.For directory operations and other file operations, see the File, Directory, and Path classes. O File é uma classe de utilitário que tem métodos estáticos principalmente para a criação de FileStream objetos com base em caminhos de arquivo.The File class is a utility class that has static methods primarily for the creation of FileStream objects based on file paths. O MemoryStream classe cria um fluxo de uma matriz de bytes e é semelhante ao FileStream classe.The MemoryStream class creates a stream from a byte array and is similar to the FileStream class.

Para obter uma lista de operações de diretório e arquivos comuns, consulte tarefas comuns de e/s.For a list of common file and directory operations, see Common I/O Tasks.

Detecção de alterações feitas na posição de fluxoDetection of Stream Position Changes

Quando um FileStream objeto não tiver uma espera exclusiva em seu identificador, outro thread poderia acessar o identificador de arquivo simultaneamente e alterar a posição do ponteiro de arquivo do sistema operacional que está associado com o identificador de arquivo.When a FileStream object does not have an exclusive hold on its handle, another thread could access the file handle concurrently and change the position of the operating system's file pointer that is associated with the file handle. Nesse caso, a posição em cache no FileStream pode comprometer a objeto e os dados armazenados no buffer.In this case, the cached position in the FileStream object and the cached data in the buffer could be compromised. O FileStream objeto rotineiramente executa verificações nos métodos que acessam o buffer em cache para garantir que a posição do identificador do sistema operacional é o mesmo que a posição em cache usada pelo FileStream objeto.The FileStream object routinely performs checks on methods that access the cached buffer to ensure that the operating system's handle position is the same as the cached position used by the FileStream object.

Se uma alteração inesperada na alça de posição é detectada em uma chamada para o Read descarta o conteúdo do buffer de método, o .NET Framework e lê o fluxo do arquivo novamente.If an unexpected change in the handle position is detected in a call to the Read method, the .NET Framework discards the contents of the buffer and reads the stream from the file again. Isso pode afetar o desempenho, dependendo do tamanho do arquivo e outros processos que poderiam afetar a posição do fluxo de arquivo.This can affect performance, depending on the size of the file and any other processes that could affect the position of the file stream.

Se uma alteração inesperada na alça de posição é detectada em uma chamada para o Write método, o conteúdo do buffer são descartados e um IOException exceção é lançada.If an unexpected change in the handle position is detected in a call to the Write method, the contents of the buffer are discarded and an IOException exception is thrown.

Um FileStream objeto não terá uma espera exclusiva em seu identificador quando qualquer um dos SafeFileHandle propriedade é acessada para expor o identificador ou o FileStream objeto receberá o SafeFileHandle propriedade em seu construtor.A FileStream object will not have an exclusive hold on its handle when either the SafeFileHandle property is accessed to expose the handle or the FileStream object is given the SafeFileHandle property in its constructor.

Construtores

FileStream(IntPtr, FileAccess) FileStream(IntPtr, FileAccess) FileStream(IntPtr, FileAccess) FileStream(IntPtr, FileAccess)

Inicializa uma nova instância da classe FileStream para o identificador de arquivo especificado, com a permissão de leitura/gravação especificada.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission.

FileStream(IntPtr, FileAccess, Boolean) FileStream(IntPtr, FileAccess, Boolean) FileStream(IntPtr, FileAccess, Boolean) FileStream(IntPtr, FileAccess, Boolean)

Inicializa uma nova instância da classe FileStream para o identificador de arquivo especificado, com a permissão de leitura/gravação especificada e a propriedade da instância FileStream.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission and FileStream instance ownership.

FileStream(IntPtr, FileAccess, Boolean, Int32) FileStream(IntPtr, FileAccess, Boolean, Int32) FileStream(IntPtr, FileAccess, Boolean, Int32) FileStream(IntPtr, FileAccess, Boolean, Int32)

Inicializa uma nova instância da classe FileStream para o identificador de arquivo especificado, com a permissão de leitura/gravação, a propriedade da instância FileStream e o tamanho do buffer especificados.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission, FileStream instance ownership, and buffer size.

FileStream(IntPtr, FileAccess, Boolean, Int32, Boolean) FileStream(IntPtr, FileAccess, Boolean, Int32, Boolean) FileStream(IntPtr, FileAccess, Boolean, Int32, Boolean) FileStream(IntPtr, FileAccess, Boolean, Int32, Boolean)

Inicializa uma nova instância da classe FileStream para o identificador de arquivo especificado, com a permissão de leitura/gravação, a propriedade da instância FileStream, o tamanho do buffer e o estado síncrono ou assíncrono especificados.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission, FileStream instance ownership, buffer size, and synchronous or asynchronous state.

FileStream(SafeFileHandle, FileAccess) FileStream(SafeFileHandle, FileAccess) FileStream(SafeFileHandle, FileAccess) FileStream(SafeFileHandle, FileAccess)

Inicializa uma nova instância da classe FileStream para o identificador de arquivo especificado, com a permissão de leitura/gravação especificada.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission.

FileStream(SafeFileHandle, FileAccess, Int32) FileStream(SafeFileHandle, FileAccess, Int32) FileStream(SafeFileHandle, FileAccess, Int32) FileStream(SafeFileHandle, FileAccess, Int32)

Inicializa uma nova instância da classe FileStream para o identificador de arquivo especificado, com a permissão de leitura/gravação especificada e tamanho do buffer.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission, and buffer size.

FileStream(SafeFileHandle, FileAccess, Int32, Boolean) FileStream(SafeFileHandle, FileAccess, Int32, Boolean) FileStream(SafeFileHandle, FileAccess, Int32, Boolean) FileStream(SafeFileHandle, FileAccess, Int32, Boolean)

Inicializa uma nova instância da classe FileStream para o identificador de arquivo, com a permissão de leitura/gravação, o tamanho do buffer e o estado síncrono ou assíncrono especificados.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission, buffer size, and synchronous or asynchronous state.

FileStream(String, FileMode) FileStream(String, FileMode) FileStream(String, FileMode) FileStream(String, FileMode)

Inicializa uma nova instância da classe FileStream com o modo de criação e o caminho especificados.Initializes a new instance of the FileStream class with the specified path and creation mode.

FileStream(String, FileMode, FileAccess) FileStream(String, FileMode, FileAccess) FileStream(String, FileMode, FileAccess) FileStream(String, FileMode, FileAccess)

Inicializa uma nova instância da classe FileStream com o caminho, o modo de criação e a permissão de leitura/gravação especificados.Initializes a new instance of the FileStream class with the specified path, creation mode, and read/write permission.

FileStream(String, FileMode, FileAccess, FileShare) FileStream(String, FileMode, FileAccess, FileShare) FileStream(String, FileMode, FileAccess, FileShare) FileStream(String, FileMode, FileAccess, FileShare)

Inicializa uma nova instância da classe FileStream com o caminho especificado, o modo de criação, permissão de leitura/gravação e permissões de compartilhamento.Initializes a new instance of the FileStream class with the specified path, creation mode, read/write permission, and sharing permission.

FileStream(String, FileMode, FileAccess, FileShare, Int32) FileStream(String, FileMode, FileAccess, FileShare, Int32) FileStream(String, FileMode, FileAccess, FileShare, Int32) FileStream(String, FileMode, FileAccess, FileShare, Int32)

Inicializa uma nova instância da classe FileStream com o caminho, o modo de criação, as permissões de leitura/gravação e compartilhamento e o tamanho do buffer especificados.Initializes a new instance of the FileStream class with the specified path, creation mode, read/write and sharing permission, and buffer size.

FileStream(String, FileMode, FileAccess, FileShare, Int32, Boolean) FileStream(String, FileMode, FileAccess, FileShare, Int32, Boolean) FileStream(String, FileMode, FileAccess, FileShare, Int32, Boolean) FileStream(String, FileMode, FileAccess, FileShare, Int32, Boolean)

Inicializa uma nova instância da classe FileStream com o caminho especificado, o modo de criação, leitura/gravação e permissões de compartilhamento, tamanho do buffer e estado síncrono ou assíncrono.Initializes a new instance of the FileStream class with the specified path, creation mode, read/write and sharing permission, buffer size, and synchronous or asynchronous state.

FileStream(String, FileMode, FileAccess, FileShare, Int32, FileOptions) FileStream(String, FileMode, FileAccess, FileShare, Int32, FileOptions) FileStream(String, FileMode, FileAccess, FileShare, Int32, FileOptions) FileStream(String, FileMode, FileAccess, FileShare, Int32, FileOptions)

Inicializa uma nova instância da classe FileStream com o caminho, o modo de criação, a permissão de compartilhamento e leitura/gravação, o acesso que outros FileStreams podem ter ao mesmo arquivo, o tamanho do buffer e as opções de arquivo adicionais especificados.Initializes a new instance of the FileStream class with the specified path, creation mode, read/write and sharing permission, the access other FileStreams can have to the same file, the buffer size, and additional file options.

FileStream(String, FileMode, FileSystemRights, FileShare, Int32, FileOptions) FileStream(String, FileMode, FileSystemRights, FileShare, Int32, FileOptions) FileStream(String, FileMode, FileSystemRights, FileShare, Int32, FileOptions) FileStream(String, FileMode, FileSystemRights, FileShare, Int32, FileOptions)

Inicializa uma nova instância da classe FileStream com o caminho, o modo de criação, os direitos de acesso e a permissão de compartilhamento, o tamanho do buffer e as opções de arquivo adicionais especificados.Initializes a new instance of the FileStream class with the specified path, creation mode, access rights and sharing permission, the buffer size, and additional file options.

FileStream(String, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity) FileStream(String, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity) FileStream(String, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity) FileStream(String, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity)

Inicializa uma nova instância da classe FileStream com o caminho, o modo de criação, os direitos de acesso e a permissão de compartilhamento, o tamanho do buffer, as opções de arquivo adicionais, o controle de acesso e a segurança de auditoria especificados.Initializes a new instance of the FileStream class with the specified path, creation mode, access rights and sharing permission, the buffer size, additional file options, access control and audit security.

Propriedades

CanRead CanRead CanRead CanRead

Obtém um valor que indica se o fluxo atual dá suporte a leitura.Gets a value that indicates whether the current stream supports reading.

CanSeek CanSeek CanSeek CanSeek

Obtém um valor que indica se o fluxo atual dá suporte a busca.Gets a value that indicates 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.

(Inherited from Stream)
CanWrite CanWrite CanWrite CanWrite

Obtém um valor que indica se o fluxo atual dá suporte a gravação.Gets a value that indicates whether the current stream supports writing.

Handle Handle Handle Handle

Obtém o identificador de arquivo do sistema operacional do arquivo que o objeto FileStream atual encapsula.Gets the operating system file handle for the file that the current FileStream object encapsulates.

IsAsync IsAsync IsAsync IsAsync

Obtém um valor que indica se FileStream foi aberto de forma assíncrona ou síncrona.Gets a value that indicates whether the FileStream was opened asynchronously or synchronously.

Length Length Length Length

Obtém o tamanho do fluxo em bytes.Gets the length in bytes of the stream.

Name Name Name Name

Obtém o caminho absoluto do arquivo aberto no FileStream.Gets the absolute path of the file opened in the FileStream.

Position Position Position Position

Obtém ou define a posição atual desse fluxo.Gets or sets the current position of this 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.

(Inherited from Stream)
SafeFileHandle SafeFileHandle SafeFileHandle SafeFileHandle

Obtém um objeto SafeFileHandle que representa o identificador de arquivo do sistema operacional para o arquivo que o objeto FileStream atual encapsula.Gets a SafeFileHandle object that represents the operating system file handle for the file that the current FileStream object encapsulates.

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.

(Inherited from Stream)

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, CancellationToken) em seu lugar.Consider using ReadAsync(Byte[], Int32, Int32, CancellationToken) 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, CancellationToken) em seu lugar.Consider using WriteAsync(Byte[], Int32, Int32, CancellationToken) instead.

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

Este membro substitui Close(), e pode haver uma documentação mais completa disponível nesse tópico.This member overrides Close(), and more complete documentation might be available in that topic.

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.

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.

(Inherited from 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.

(Inherited from Stream)
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.

(Inherited from 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.

(Inherited from Stream)
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.

(Inherited from Stream)
CopyToAsync(Stream, Int32, CancellationToken) CopyToAsync(Stream, Int32, CancellationToken) CopyToAsync(Stream, Int32, CancellationToken) CopyToAsync(Stream, Int32, CancellationToken)
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.

(Inherited from Stream)
Dispose() Dispose() Dispose() Dispose()

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

(Inherited from Stream)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

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

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

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

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

Termina uma operação de gravação assíncrona e bloqueia até que a operação de E/S seja concluída.Ends an asynchronous write operation and blocks until the I/O operation is complete. (Considere o uso de WriteAsync(Byte[], Int32, Int32, CancellationToken) em seu lugar.)(Consider using WriteAsync(Byte[], Int32, Int32, CancellationToken) 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)
Finalize() Finalize() Finalize() Finalize()

Garante que os recursos são liberados e outras operações de limpeza são executadas quando o coletor de lixo recupera o objeto FileStream.Ensures that resources are freed and other cleanup operations are performed when the garbage collector reclaims the FileStream.

Flush() Flush() Flush() Flush()

Limpa os buffers desse fluxo e faz com que todos os dados armazenados em buffer sejam gravados no arquivo.Clears buffers for this stream and causes any buffered data to be written to the file.

Flush(Boolean) Flush(Boolean) Flush(Boolean) Flush(Boolean)

Limpa os buffers desse fluxo e faz com que os dados armazenados em buffer sejam gravados no arquivo e também limpa todos os buffers de arquivo intermediário.Clears buffers for this stream and causes any buffered data to be written to the file, and also clears all intermediate file buffers.

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.

(Inherited from Stream)
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.

GetAccessControl() GetAccessControl() GetAccessControl() GetAccessControl()

Obtém um objeto FileSecurity que encapsula as entradas da ACL (lista de controle de acesso) do arquivo descrito pelo objeto FileStream atual.Gets a FileSecurity object that encapsulates the access control list (ACL) entries for the file described by the current FileStream object.

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)
Lock(Int64, Int64) Lock(Int64, Int64) Lock(Int64, Int64) Lock(Int64, Int64)

Impede que outros processos façam a leitura ou gravação no FileStream.Prevents other processes from reading from or writing to the FileStream.

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.

(Inherited from Stream)
Read(Byte[], Int32, Int32) Read(Byte[], Int32, Int32) Read(Byte[], Int32, Int32) Read(Byte[], Int32, Int32)

Lê um bloco de bytes do fluxo e grava os dados em um buffer específico.Reads a block of bytes from the stream and writes the data in a given buffer.

Read(Span<Byte>) Read(Span<Byte>) Read(Span<Byte>) Read(Span<Byte>)
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.

(Inherited from Stream)
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)
ReadByte() ReadByte() ReadByte() ReadByte()

Lê um byte do arquivo e avança a posição de leitura em um byte.Reads a byte from the file and advances the read position one byte.

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

Define a posição atual do fluxo para o valor especificado.Sets the current position of this stream to the given value.

SetAccessControl(FileSecurity) SetAccessControl(FileSecurity) SetAccessControl(FileSecurity) SetAccessControl(FileSecurity)

Aplica-se a entradas ACL (Lista de Controle de Acesso) descritas por um objeto FileSecurity para o arquivo descrito pelo objeto FileStream atual.Applies access control list (ACL) entries described by a FileSecurity object to the file described by the current FileStream object.

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

Define o tamanho deste fluxo para o valor especificado.Sets the length of this stream to the given value.

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)
Unlock(Int64, Int64) Unlock(Int64, Int64) Unlock(Int64, Int64) Unlock(Int64, Int64)

Permite o acesso por outros processos a todo ou parte de um arquivo que foi bloqueado anteriormente.Allows access by other processes to all or part of a file that was previously locked.

Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32)

Grava um bloco de bytes no fluxo de arquivo.Writes a block of bytes to the file stream.

Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>)
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.

(Inherited from Stream)
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)
WriteByte(Byte) WriteByte(Byte) WriteByte(Byte) WriteByte(Byte)

Grava um byte na posição atual no fluxo de arquivos.Writes a byte to the current position in the file stream.

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.

(Inherited from Stream)

Métodos de Extensão

GetAccessControl(FileStream) GetAccessControl(FileStream) GetAccessControl(FileStream) GetAccessControl(FileStream)
SetAccessControl(FileStream, FileSecurity) SetAccessControl(FileStream, FileSecurity) SetAccessControl(FileStream, FileSecurity) SetAccessControl(FileStream, FileSecurity)
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