Stream Osztály

Definíció

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

Öröklődés

Object

Stream

Öröklődés

Object

MarshalByRefObject

Stream

Származtatott

Microsoft.Extensions.AI.HostedFileDownloadStream

Microsoft.JScript.COMCharStream

System.Data.OracleClient.OracleBFile

System.Data.OracleClient.OracleLob

System.Data.SqlTypes.SqlFileStream

Tovább…

Attribútumok

SerializableAttribute ComVisibleAttribute

Megvalósítás

IDisposable IAsyncDisposable

Példák

Az alábbi példa bemutatja, hogyan használhat két FileStream objektumot a fájlok aszinkron másolására az egyik könyvtárból egy másik könyvtárba. Az FileStream osztály az Stream osztályból származik. Figyelje meg, hogy a Click vezérlő eseménykezelője Button a módosítóval async van megjelölve, mert aszinkron metódust hív meg.

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

Megjegyzések

Stream az összes stream absztrakt alaposztálya. A stream bájtok sorozatának absztrakciója, például fájl, bemeneti/kimeneti eszköz, folyamatközi kommunikációs cső vagy TCP/IP-szoftvercsatorna. Az Stream osztály és származtatott osztályai általános képet nyújtanak ezekről a különböző típusú bemenetről és kimenetről, és elkülönítik a programozót az operációs rendszer és a mögöttes eszközök konkrét részleteitől.

A streamek három alapvető műveletet foglalnak magukban:

• Streamekből is olvashat. Az olvasás az adatok átvitele egy adatfolyamból egy adatstruktúrába, például bájtokból álló tömbbe.

• Streamekbe is írhat. Az írás az adatok átvitele egy adatstruktúrából egy adatfolyamba.

• A streamek támogathatják a keresést. A keresés az aktuális pozíció lekérdezésére és módosítására vonatkozik egy streamen belül. A keresési képesség attól függ, hogy a stream milyen típusú háttértárolóval rendelkezik. A hálózati streamek például nem rendelkeznek egységes koncepcióval az aktuális pozícióról, ezért általában nem támogatják a keresést.

Az öröklődő Stream leggyakrabban használt streamek közül néhány a következők FileStream: és MemoryStream.

A mögöttes adatforrástól vagy adattártól függően előfordulhat, hogy a streamek csak néhány ilyen képességet támogatnak. A streameket az CanReadosztály , CanWriteés CanSeek tulajdonságai Stream segítségével kérdezheti le a képességeiről.

Az Read adatok olvasása és Write írása különböző formátumokban. A keresést támogató streamek esetében a Seek metódusok és SetLength a PositionLength tulajdonságok használatával lekérdezheti és módosíthatja a streamek aktuális pozícióját és hosszát.

Ez a típus implementálja a IDisposable felületet. Ha befejezte a típus használatát, közvetlenül (a metódus meghívásával) vagy közvetetten (például using a C#-ban) kell elhelyeznie Dispose a típust. További információ: Az IDisposable-t megvalósító objektum használata.

Az Stream objektum törlése kiüríti a pufferelt adatokat, és lényegében meghívja Önnek a Flush metódust. Dispose Emellett olyan operációsrendszer-erőforrásokat is felszabadít, mint a fájlfogópontok, a hálózati kapcsolatok vagy a belső puffereléshez használt memória. Az BufferedStream osztály lehetővé teszi egy pufferelt stream egy másik stream körüli körbefuttatását az olvasási és írási teljesítmény javítása érdekében.

A .NET Framework 4.5-től kezdve a Stream osztály aszinkron metódusokat tartalmaz az aszinkron műveletek egyszerűsítéséhez. Az aszinkron metódus a nevében szerepelAsync, például ReadAsync: , WriteAsyncCopyToAsyncés FlushAsync. Ezek a módszerek lehetővé teszik az erőforrás-igényes I/O-műveletek végrehajtását a fő szál blokkolása nélkül. Ez a teljesítménybeli szempont különösen fontos egy Windows 8.x Áruházbeli vagy asztali alkalmazásban, ahol egy időigényes streamelési művelet blokkolhatja a felhasználói felületi szálat, és úgy jelenik meg, mintha az alkalmazás nem működna. Az aszinkron metódusok a async és await kulcsszavakkal együtt használatosak Visual Basic és C# nyelven.

Ha Windows 8.x Áruházbeli alkalmazásban használják, a Stream két bővítménymetelyt tartalmaz: AsInputStream és AsOutputStream. Ezek a metódusok átalakítanak egy Stream objektumot a Windows-futtatókörnyezet egy adatfolyamává. A Windows-futtatókörnyezet streameket Stream objektummá is konvertálhatja a AsStreamForRead és AsStreamForWrite metódusokkal. További információ: Hogyan is: Konvertálás .NET keretrendszer streamek és Windows-futtatókörnyezet streamek között

Egyes stream-implementációk helyi pufferelést végeznek a mögöttes adatokon a teljesítmény javítása érdekében. Az ilyen adatfolyamok esetében a Flush belső pufferek törléséhez vagy FlushAsync a metódus használatával biztosíthatja, hogy az összes adat az alapul szolgáló adatforrásba vagy adattárba lett-e írva.

Ha olyan streamre van szüksége, amely nem rendelkezik háttértárolóval (más néven bitgyűjtővel), a Null mező használatával lekérheti az erre a célra tervezett stream egy példányát.

Megjegyzések az implementálókhoz

Ha származtatott osztályt Streamimplementál, meg kell adnia a implementációkat és Read(Byte[], Int32, Int32) a Write(Byte[], Int32, Int32) metódusokat. Az aszinkron metódusok a ReadAsync(Byte[], Int32, Int32)WriteAsync(Byte[], Int32, Int32) szinkron metódusokat CopyToAsync(Stream)Read(Byte[], Int32, Int32)Write(Byte[], Int32, Int32) és azok implementációit használják. Ezért az aszinkron metódusok implementációi Read(Byte[], Int32, Int32)Write(Byte[], Int32, Int32) és azok megfelelően fognak működni. Az alapértelmezett implementációk ReadByte()WriteByte(Byte) egy új, egyelemű bájttömböt hoznak létre, majd meghívják az és Read(Byte[], Int32, Int32)Write(Byte[], Int32, Int32)a . Ha a forrásból Streamszármazik, javasoljuk, hogy a lényegesen jobb teljesítmény érdekében felülbírálja ezeket a metódusokat a belső puffer eléréséhez, ha van ilyen. Emellett meg kell adnia a CanRead, CanSeek, , CanWriteFlush(), Length, PositionSeek(Int64, SeekOrigin)és SetLength(Int64).

Ne bírálja felül a Close() metódust, hanem helyezze az összes tisztítási Stream logikát a Dispose(Boolean) metódusba. További információ: Az elidegenítési módszer implementálása.

Lásd még

• FileStream
• MemoryStream
• BufferedStream
• Fájl és folyam I/O
• A következőhöz: Konvertálás .NET keretrendszer-streamek és Windows-futtatókörnyezet streamek között