FileStream (Clase)

Utilice la clase FileStream para leer de, escriba, abierto, y cierre los archivos en un sistema de archivos, y manipular otros identificadores del sistema operativo archivo (el archivo relacionados, incluidos canalizaciones, entrada estándar, y salida estándar. Puede utilizar Read, Write, CopyTo, y los métodos Flush para realizar operaciones síncronas, o ReadAsync, WriteAsync, CopyToAsync, y los métodos FlushAsync para realizar operaciones asincrónicas. Utilice los métodos asincrónicos para realizar operaciones de archivo recurso- intensivas sin bloquear el subproceso principal. Esta consideración de rendimiento es especialmente importante en una aplicación Tienda Windows o la aplicación escritorio donde una operación larga de la secuencia puede bloquear el subproceso de la interfaz de usuario y crear que aparece la aplicación como si no funciona. FileStream almacena en búfer la entrada y salida para mejor rendimiento.

La propiedad IsAsync detecta si el identificador de archivo se ha abierto de forma asincrónica. Especifica este valor cuando se crea una instancia de la clase FileStream mediante un constructor con isAsync, useAsync, o parámetro options . Cuando la propiedad es true, la secuencia utiliza E/S superpuesta para realizar operaciones de archivo de forma asincrónica. Sin embargo, la propiedad IsAsync no tiene que ser true para llamar a ReadAsync, WriteAsync, o un método CopyToAsync . Cuando la propiedad IsAsync es false y la lectura asincrónica y las operaciones de escritura, el subproceso de la interfaz de usuario aún no está bloqueado, pero la operación de E/S real se realiza de forma sincrónica.

El método Seek admite el acceso aleatorio a los archivos. Seek permite que se mueva la posición de lectura/escritura a cualquier posición dentro del archivo. Esto se realiza mediante parámetros de punto de referencia de desplazamiento de byte. El desplazamiento de bytes es relativo al punto de referencia de búsqueda, que puede ser el inicio, la posición actual, o el final del archivo subyacente, como se representa por los tres miembros de la enumeración SeekOrigin .

Nota
Los archivos de disco siempre admiten el acceso aleatorio. En el momento de la construcción, el valor de propiedad CanSeek se establece en true o a false según el tipo de archivo subyacente. Si el tipo de archivo subyacente es FILE_TYPE_DISK, según winbase.h, el valor de propiedad CanSeek es true. En caso contrario, el valor de la propiedad CanSeek es false.

Si un proceso termina con parte de un archivo bloqueado o cierra un archivo que tiene bloqueos pendientes, el comportamiento no estará definido.

Para las operaciones de directorio y otras operaciones de archivo, vea File, Directory, y las clases Path . La clase File es una clase de utilidad que tiene métodos estáticos principalmente para la creación de objetos FileStream basándose en las rutas de acceso. La clase MemoryStream crea una secuencia de una matriz de bytes que es similar a la clase FileStream .

Para obtener una lista de operaciones de archivo comunes y directorio, vea Tareas de E/S comunes.

Detección de cambios de la posición de la secuencia

En el siguiente ejemplo se muestran algunos de los constructores FileStream.

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);
    }
}

El ejemplo siguiente muestra cómo escribir en un archivo de forma asincrónica.

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);
            }
        }
    }
}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

Referencia

Otros recursos