Stream (Clase)

Las secuencias comprenden tres operaciones fundamentales.

• Es posible leer información de las secuencias. La lectura es la transferencia de datos desde una secuencia a una estructura de datos, como, por ejemplo, una matriz de bytes.

• Se puede escribir información en las secuencias. La escritura es la transferencia de datos desde una estructura de datos hasta una secuencia.

• Las secuencias pueden admitir operaciones de búsqueda. La búsqueda hace referencia a ver y modificar la posición actual en una secuencia. La capacidad de realizar este tipo de búsquedas depende del tipo de memoria auxiliar que posea una secuencia. Por ejemplo, las secuencias de red no trabajan con un concepto unificado de "posición actual" y, por tanto, no suelen admitir búsquedas.

Stream es la clase base de todas las secuencias. Una secuencia es una abstracción de una secuencia de bytes, como un archivo, un dispositivo de entrada/salida, un canal de comunicación interprocesos o un socket TCP/IP. La clase Stream y sus clases derivadas proporcionan una vista genérica estos diferentes tipos de entrada y de salida, y aislar el programador de los detalles específicos del sistema operativo y dispositivos subyacentes.

Según el origen de datos o repositorio subyacente, las secuencias pueden admitir sólo algunas de estas características. Puede ver una secuencia por sus capacidades mediante CanRead, CanWrite, y las propiedades CanSeek de la clase Stream .

Los métodos Read y Write leen y escriben datos en varios formatos. Para secuencias que admiten búsquedas, se pueden utilizar los métodos Seek y SetLength, y las propiedades Position y Length para consultar y modificar la posición y longitud actuales de una secuencia.

A partir .NET Framework 4.5, la clase Stream incluye métodos async para simplificar las operaciones asincrónicas. Un método async contiene Async en su nombre, como ReadAsync, WriteAsync, CopyToAsync, y FlushAsync. Estos métodos permiten realizar operaciones de E/S 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. Los métodos async se utilizan junto con las palabras clave async y await en Visual Basic y C#.

Cuando se utiliza en una aplicación Tienda Windows , Stream incluye dos métodos de extensión: AsInputStream y AsOutputStream. Estos métodos convierten un objeto Stream a una secuencia en Windows en tiempo de ejecución. También puede convertir una secuencia en Windows en tiempo de ejecución a un objeto Stream mediante los métodos AsStreamForRead y AsStreamForWrite .

Algunas implementaciones de secuencia almacenan los datos subyacentes en un búfer local para mejorar el rendimiento. Para tales secuencias, puede utilizar el método Flush o FlushAsync para borrar cualquier búfer interno y para asegurarse de que todos los datos se ha escrito en el origen de datos o al repositorio subyacente.

Eliminar un objeto Stream vuelca los datos almacenados en búfer, y esencialmente llama al método Flush automáticamente. Dispose también libera los recursos del sistema operativo como identificadores de archivos, conexiones de red o memoria usados para cualquier almacenamiento en búfer interno. La clase BufferedStream permite que una secuencia pueda estar contenida en otra secuencia almacenada en búfer con el fin de mejorar el rendimiento de lectura y escritura.

Si necesita transmitir sin el dispositivo de copia de seguridad (también conocido como depósito de bit), utilice el campo Null para recuperar una instancia de una secuencia que está diseñado para este propósito.

Cuando se implementa una clase derivada Stream, debe proporcionar las implementaciones para los métodos Read y Write . Los métodos asincrónicos ReadAsync, WriteAsync, y uso CopyToAsync los métodos sincrónicos Read y Write en sus implementaciones. Por consiguiente, las implementaciones Read y Write funcionarán correctamente con los métodos asincrónicos. Las implementaciones predeterminadas de ReadByte y WriteByte crean una nueva matriz de bytes de un solo elemento y, después, llaman a las implementaciones de Read y Write. Cuando se deriva Stream, se recomienda reemplazar estos métodos para tener acceso al búfer interno, si existe, para notablemente el mejor rendimiento. También se deben proporcionar implementaciones de CanRead, CanSeek, CanWrite, Flush, Length, Position, Seek y SetLength.

No reemplace el método Close , en su lugar, coloque toda la lógica de limpieza Stream en el método Dispose . Para obtener más información, vea Implementar un método Dispose.

El ejemplo siguiente se muestra cómo utilizar dos objetos FileStream asincrónica para copiar los archivos de un directorio en otro directorio. La clase FileStream se deriva de la clase Stream. Observe que marcan el controlador de eventos Click para el control Button con el modificador async porque llama a un método asincrónico

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

.NET Framework

.NET Framework Client Profile

Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

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