FileStream Classe

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
public class FileStream : System.IO.Stream
[System.Runtime.InteropServices.ComVisible(true)]
public class FileStream : System.IO.Stream
type FileStream = class
    inherit Stream
[<System.Runtime.InteropServices.ComVisible(true)>]
type FileStream = class
    inherit Stream
Public Class FileStream
Inherits Stream
Herança
FileStream
Herança
Derivado
Atributos

Exemplos

O exemplo a seguir demonstra alguns dos 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.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(1023) 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 do WPF que tem um TextBlock chamado userinput e um botão conectado a um manipulador de eventos de clique chamado Button_Click.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 existente 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 a FileStream classe para ler, gravar, abrir e fechar arquivos em um sistema de arquivos e manipular outros identificadores do sistema operacional relacionados a arquivos, incluindo pipes, entrada padrão 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 os Read métodos,, Write CopyTo e Flush para executar operações síncronas, ou os ReadAsync métodos,, WriteAsync CopyToAsync e FlushAsync para executar operações assíncronas.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 com 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 armazena em buffer a entrada e a saída para melhorar o desempenho.FileStream buffers input and output for better performance.

Importante

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

A 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. Você especifica esse valor quando cria uma instância da FileStream classe usando um construtor que tem um isAsync useAsync parâmetro, ou options .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 é true , o fluxo utiliza 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, a IsAsync propriedade não precisa ser true chamar o ReadAsync método, WriteAsync ou CopyToAsync .However, the IsAsync property does not have to be true to call the ReadAsync, WriteAsync, or CopyToAsync method. Quando a IsAsync propriedade é false e você chama as operações de leitura e gravação assíncronas, o thread da interface do usuário ainda não é 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 aos arquivos.The Seek method supports random access to files. Seek permite que a posição de leitura/gravação seja movida 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 byte.This is done with byte offset reference point parameters. O deslocamento de byte é relativo ao ponto de referência de busca, que pode ser o início, a posição atual ou o final do arquivo subjacente, conforme representado pelos três membros da 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

Os arquivos de disco sempre dão suporte ao acesso aleatório.Disk files always support random access. No momento da construção, o CanSeek valor da propriedade é definido como true ou false dependendo do tipo de arquivo subjacente.At the time of construction, the CanSeek property value is set to true or false depending on the underlying file type. Se o tipo de arquivo subjacente for FILE_TYPE_DISK, conforme definido em Winbase. h, o CanSeek valor da propriedade será true .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 valor da propriedade será false .Otherwise, the CanSeek property value is false.

Se um processo for encerrado com parte de um arquivo bloqueado ou fechar um arquivo com 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 as File Directory classes, e Path .For directory operations and other file operations, see the File, Directory, and Path classes. A File classe é 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. A MemoryStream classe cria um fluxo de uma matriz de bytes e é semelhante à 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 arquivo e diretório 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 tem 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 ao 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 armazenada em cache no FileStream objeto e os dados armazenados em cache no buffer podem ser comprometidos.In this case, the cached position in the FileStream object and the cached data in the buffer could be compromised. O FileStream objeto executa verificações rotineiras em métodos que acessam o buffer armazenado em cache para garantir que a posição do identificador do sistema operacional seja a mesma que a posição armazenada 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 posição do identificador for detectada em uma chamada para o Read método, a .NET Framework descartará o conteúdo do buffer e lerá 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 de quaisquer outros processos que possam afetar a posição do fluxo de arquivos.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 posição do identificador for detectada em uma chamada para o Write método, o conteúdo do buffer será descartado e uma IOException exceção será 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 a SafeFileHandle propriedade for acessada para expor o identificador ou o FileStream objeto receber a 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)
Obsoleto.
Obsoleto.
Obsoleto.

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)
Obsoleto.
Obsoleto.
Obsoleto.

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)
Obsoleto.
Obsoleto.
Obsoleto.

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)
Obsoleto.
Obsoleto.
Obsoleto.

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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

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

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

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.

(Herdado de Stream)
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
Obsoleto.
Obsoleto.
Obsoleto.

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

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

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

Name

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

Position

Obtém ou define a posição atual desse fluxo.Gets or sets the current position of this stream.

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.

(Herdado de Stream)
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

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.

(Herdado de Stream)

Métodos

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.

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.)

(Herdado de Stream)
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.

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.)

(Herdado de Stream)
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.

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.

(Herdado de 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.

(Herdado de Stream)
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.

(Herdado de 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.

(Herdado de Stream)
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.

(Herdado de Stream)
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.

(Herdado de Stream)
CopyToAsync(Stream, Int32, CancellationToken)

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

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.

(Herdado de Stream)
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.

(Herdado de MarshalByRefObject)
CreateWaitHandle()
Obsoleto.

Aloca um objeto WaitHandle.Allocates a WaitHandle object.

(Herdado de Stream)
Dispose()

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

(Herdado de Stream)
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()

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

DisposeAsync()

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

(Herdado de Stream)
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.)

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.)

(Herdado de Stream)
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.)

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.)

(Herdado de Stream)
Equals(Object)

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

(Herdado de Object)
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()

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)

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()

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.

(Herdado de Stream)
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.

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.

(Herdado de Stream)
GetAccessControl()

Obtém um objeto FileSecurity que encapsula as entradas de 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()

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

(Herdado de Object)
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.

(Herdado de MarshalByRefObject)
GetType()

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

(Herdado de Object)
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.

(Herdado de MarshalByRefObject)
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()

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

(Herdado de Object)
MemberwiseClone(Boolean)

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

(Herdado de MarshalByRefObject)
ObjectInvariant()
Obsoleto.

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

(Herdado de Stream)
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>)

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

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.

(Herdado de Stream)
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.

(Herdado de Stream)
ReadAsync(Byte[], Int32, Int32, CancellationToken)

Lê de forma assíncrona uma sequência de bytes do fluxo de arquivo atual, grava-os em uma matriz de bytes começando no deslocamento especificado, avança a posição no fluxo de arquivo até o número de bytes lidos e monitora as solicitações de cancelamento.Asynchronously reads a sequence of bytes from the current file stream and writes them to a byte array beginning at a specified offset, advances the position within the file stream by the number of bytes read, and monitors cancellation requests.

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.

(Herdado de Stream)
ReadAsync(Memory<Byte>, CancellationToken)

Lê de forma assíncrona uma sequência de bytes do fluxo de arquivo atual e grava-os em uma região de memória, avança a posição no fluxo de arquivo até o número de bytes lidos e monitora as solicitações de cancelamento.Asynchronously reads a sequence of bytes from the current file stream and writes them to a memory region, advances the position within the file stream by the number of bytes read, and monitors cancellation requests.

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.

(Herdado de Stream)
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)

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

SetAccessControl(FileSecurity)

Aplica-se a entradas da 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)

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

ToString()

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

(Herdado de Object)
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)

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

Write(ReadOnlySpan<Byte>)

Grava uma sequência de bytes de um intervalo somente leitura no fluxo de arquivo atual e avança a posição atual nesse fluxo de arquivo até o número de bytes gravados.Writes a sequence of bytes from a read-only span to the current file stream and advances the current position within this file stream by the number of bytes written.

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.

(Herdado de Stream)
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.

(Herdado de Stream)
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(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.

(Herdado de Stream)
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Grava de forma assíncrona uma sequência de bytes de uma região de memória no fluxo de arquivo atual, avança a posição atual nesse fluxo de arquivo até o número de bytes gravados e monitora as solicitações de cancelamento.Asynchronously writes a sequence of bytes from a memory region to the current file stream, advances the current position within this file stream by the number of bytes written, and monitors cancellation requests.

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.

(Herdado de Stream)
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()

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

(Herdado de Stream)

Métodos de Extensão

GetAccessControl(FileStream)

Retorna as informações de segurança de um arquivo.Returns the security information of a file.

SetAccessControl(FileStream, FileSecurity)

Altera os atributos de segurança de um arquivo existente.Changes the security attributes of an existing file.

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)

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)

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

ConfigureAwait(IAsyncDisposable, Boolean)

Configura como as esperas nas tarefas retornadas de um descartável assíncrono são realizadas.Configures how awaits on the tasks returned from an async disposable are performed.

Aplica-se a

Confira também