Stream Třída

Definice

public ref class Stream abstract : IDisposable

public ref class Stream abstract : MarshalByRefObject, IAsyncDisposable, IDisposable

public ref class Stream abstract : MarshalByRefObject, IDisposable

public abstract class Stream : IDisposable

public abstract class Stream : MarshalByRefObject, IAsyncDisposable, IDisposable

public abstract class Stream : MarshalByRefObject, IDisposable

[System.Serializable]
public abstract class Stream : MarshalByRefObject, IDisposable

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Stream : MarshalByRefObject, IDisposable

type Stream = class
    interface IDisposable

type Stream = class
    inherit MarshalByRefObject
    interface IAsyncDisposable
    interface IDisposable

type Stream = class
    inherit MarshalByRefObject
    interface IDisposable

[<System.Serializable>]
type Stream = class
    inherit MarshalByRefObject
    interface IDisposable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Stream = class
    inherit MarshalByRefObject
    interface IDisposable

Public MustInherit Class Stream
Implements IDisposable

Public MustInherit Class Stream
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDisposable

Public MustInherit Class Stream
Inherits MarshalByRefObject
Implements IDisposable

Dědičnost

Object

Stream

Dědičnost

Object

MarshalByRefObject

Stream

Odvozené

Microsoft.JScript.COMCharStream

System.Data.OracleClient.OracleBFile

System.Data.OracleClient.OracleLob

System.Data.SqlTypes.SqlFileStream

System.IO.BufferedStream

Více…

Atributy

SerializableAttribute ComVisibleAttribute

Implementuje

IDisposable IAsyncDisposable

Příklady

Následující příklad ukazuje, jak použít dva FileStream objekty k asynchronnímu kopírování souborů z jednoho adresáře do jiného adresáře. Třída FileStream je odvozena od třídy Stream. Všimněte si, že obslužná rutina Click události pro ovládací prvek Button je označena modifikátorem async, protože volá asynchronní metodu.

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

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

        private async void Button_Click(object sender, RoutedEventArgs e)
        {
            string StartDirectory = @"c:\Users\exampleuser\start";
            string EndDirectory = @"c:\Users\exampleuser\end";

            foreach (string filename in Directory.EnumerateFiles(StartDirectory))
            {
                using (FileStream SourceStream = File.Open(filename, FileMode.Open))
                {
                    using (FileStream DestinationStream = File.Create(EndDirectory + filename.Substring(filename.LastIndexOf('\\'))))
                    {
                        await SourceStream.CopyToAsync(DestinationStream);
                    }
                }
            }
        }
    }
}

Imports System.IO

Class MainWindow

    Private Async Sub Button_Click(sender As Object, e As RoutedEventArgs)
        Dim StartDirectory As String = "c:\Users\exampleuser\start"
        Dim EndDirectory As String = "c:\Users\exampleuser\end"

        For Each filename As String In Directory.EnumerateFiles(StartDirectory)
            Using SourceStream As FileStream = File.Open(filename, FileMode.Open)
                Using DestinationStream As FileStream = File.Create(EndDirectory + filename.Substring(filename.LastIndexOf("\"c)))
                    Await SourceStream.CopyToAsync(DestinationStream)
                End Using

            End Using
        Next
    End Sub

End Class

Poznámky

Stream je abstraktní základní třída všech datových proudů. Stream je abstrakce posloupnosti bajtů, jako je soubor, vstupní/výstupní zařízení, komunikační kanál mezi procesy nebo soket TCP/IP. Třída Stream a jeho odvozené třídy poskytují obecné zobrazení těchto různých typů vstupu a výstupu a izolovat programátora od konkrétních podrobností operačního systému a základních zařízení.

Streamy zahrnují tři základní operace:

• Můžete číst ze streamů. Čtení je přenos dat z datového proudu do datové struktury, například pole bajtů.

• Do streamů můžete zapisovat. Zápis je přenos dat ze struktury dat do datového proudu.

• Streamy můžou podporovat hledání. Hledání odkazuje na dotazování a úpravu aktuální pozice v rámci datového proudu. Funkce hledání závisí na druhu záložního úložiště, které datový proud obsahuje. Například síťové streamy nemají jednotný koncept aktuální pozice, a proto obvykle nepodporují hledání.

Některé z běžně používaných datových proudů, které dědí z Stream, jsou FileStreama MemoryStream.

V závislosti na podkladovém zdroji dat nebo úložišti můžou streamy podporovat pouze některé z těchto funkcí. Stream můžete dotazovat na své schopnosti pomocí CanRead, CanWritea CanSeek vlastností třídy Stream.

Read a Write metody čtou a zapisuje data v různých formátech. U datových proudů, které podporují hledání, použijte Seek a SetLength metody a Position a Length vlastnosti k dotazování a úpravě aktuální pozice a délky datového proudu.

Tento typ implementuje rozhraní IDisposable. Jakmile typ dokončíte, měli byste ho odstranit buď přímo, nebo nepřímo. Chcete-li typ odstranit přímo, zavolejte jeho Dispose metodu v bloku try/catch. Pokud ho chcete zlikvidovat nepřímo, použijte konstruktor jazyka, jako je using (v jazyce C#) nebo Using (v jazyce Visual Basic). Další informace naleznete v části Použití objektu, který implementuje IDisposable v tématu IDisposable rozhraní.

Vyprázdnění Stream objektu vyprázdní všechna uložená data ve vyrovnávací paměti a v podstatě za vás zavolá metodu Flush. Dispose také vydává prostředky operačního systému, jako jsou popisovače souborů, síťová připojení nebo paměť používané pro jakékoli interní ukládání do vyrovnávací paměti. Třída BufferedStream poskytuje schopnost zabalit stream do vyrovnávací paměti kolem jiného datového proudu, aby se zlepšil výkon čtení a zápisu.

Počínaje rozhraním .NET Framework 4.5 obsahuje třída Stream asynchronní metody pro zjednodušení asynchronních operací. Asynchronní metoda obsahuje Async v názvu, například ReadAsync, WriteAsync, CopyToAsynca FlushAsync. Tyto metody umožňují provádět vstupně-výstupní operace náročné na prostředky bez blokování hlavního vlákna. Tento faktor výkonu je zvlášť důležitý v aplikaci pro Windows 8.x Store nebo desktopové aplikaci, kde časově náročná operace streamu může blokovat vlákno uživatelského rozhraní a zobrazit aplikaci, jako by nefungovala. Asynchronní metody se používají ve spojení s klíčovými slovy async a await v jazyce Visual Basic a C#.

Při použití v aplikaci pro Windows 8.x Store obsahuje Stream dvě metody rozšíření: AsInputStream a AsOutputStream. Tyto metody převedou objekt Stream na datový proud v prostředí Windows Runtime. Datový proud v prostředí Windows Runtime můžete také převést na objekt Stream pomocí AsStreamForRead a AsStreamForWrite metod. Další informace najdete v tématu Postupy: Převod mezi datovými proudy rozhraní .NET Framework a streamy prostředí Windows Runtime

Některé implementace datových proudů provádějí místní ukládání podkladových dat do vyrovnávací paměti za účelem zlepšení výkonu. U těchto datových proudů můžete použít metodu Flush nebo FlushAsync k vymazání všech interních vyrovnávacích pamětí a k zajištění zápisu všech dat do podkladového zdroje dat nebo úložiště.

Pokud potřebujete datový proud bez záložního úložiště (označovaného také jako bitový kbelík), použijte pole Null k načtení instance datového proudu, který je pro tento účel navržený.

Poznámky pro implementátory

Při implementaci odvozené třídy Streammusíte poskytnout implementace pro Read(Byte[], Int32, Int32) a Write(Byte[], Int32, Int32) metody. Asynchronní metody ReadAsync(Byte[], Int32, Int32), WriteAsync(Byte[], Int32, Int32)a CopyToAsync(Stream) používají synchronní metody Read(Byte[], Int32, Int32) a Write(Byte[], Int32, Int32) v jejich implementacích. Proto vaše implementace Read(Byte[], Int32, Int32) a Write(Byte[], Int32, Int32) budou správně fungovat s asynchronními metodami. Výchozí implementace ReadByte() a WriteByte(Byte) vytvořit nové pole bajtů s jedním prvkem a pak volat implementace Read(Byte[], Int32, Int32) a Write(Byte[], Int32, Int32). Při odvození z Streamdoporučujeme tyto metody přepsat pro přístup k interní vyrovnávací paměti, pokud ho máte, pro podstatně lepší výkon. Musíte také poskytnout implementace CanRead, CanSeek, CanWrite, Flush(), Length, Position, Seek(Int64, SeekOrigin)a SetLength(Int64).

Nepřepsat metodu Close() místo toho vložte do metody Dispose(Boolean) veškerou logiku čištění Stream. Další informace naleznete v tématu Implementace metody Dispose.

Konstruktory

Pole

Vlastnosti

Metody

Explicitní implementace rozhraní

Metody rozšíření

Platí pro

Viz také

• FileStream
• MemoryStream
• BufferedStream
• soubor a streamování vstupně-výstupních
• Postupy: Převod mezi datovými proudy rozhraní .NET Framework a streamy prostředí Windows Runtime