Stream-Klasse

Streams umfassen drei grundlegende Vorgänge:

• Streams können gelesen werden. Bei einem Lesevorgang werden Daten von einem Stream in eine Datenstruktur übertragen, beispielsweise in ein Bytearray.

• In Streams kann geschrieben werden. Bei einem Schreibvorgang werden Daten aus einer Datenstruktur in einen Stream übertragen.

• Streams können Suchvorgänge unterstützen. Das Suchen verweist das Abfragen und Ändern der aktuellen Position innerhalb eines Streams an. Die Suchfunktion ist von der Art des Sicherungsspeichers eines Streams abhängig. Netzwerkstreams verfügen beispielsweise über kein einheitliches Konzept einer aktuellen Position und unterstützen daher das Suchen in der Regel nicht.

Stream ist die abstrakte Basisklasse aller Streams. Ein Stream ist ein Modell für eine Folge von Bytes, wie eine Datei, ein Eingabe-/Ausgabegerät, eine Pipe für die Kommunikation zwischen Prozessen oder ein TCP/IP-Socket. Die Stream-Klasse und die abgeleiteten Klassen bieten eine allgemeine Ansicht dieser verschiedenen Typen der Eingabe und der Ausgabe und suchen den Programmierer von bestimmten Details des Betriebssystems und der zugrunde liegenden Geräte.

Abhängig von der zugrunde liegenden Datenquelle oder vom Repository unterstützen Streams möglicherweise nur einige dieser Funktionen. Sie können einen Stream für seine Funktionen abfragen, indem Sie CanRead, CanWrite verwenden, und CanSeek-Eigenschaften Stream darstellen.

Die Read-Methode und die Write-Methode lesen und schreiben Daten in verschiedenen Formaten. Bei Streams, die das Suchen unterstützen, verwenden Sie die Seek-Methode und die SetLength-Methode sowie die Position-Eigenschaft und die Length-Eigenschaft, um die aktuelle Position und Länge eines Streams abzufragen und zu bearbeiten.

Ab .NET Framework 4.5, umfasst die Stream-Klasse asynchrone Methoden, um asynchrone Vorgänge zu vereinfachen. Eine asynchrone Methode enthält Async in ihrem Namen, wie ReadAsync, WriteAsync, CopyToAsync und FlushAsync. Diese Methoden ermöglichen es Ihnen, ressourcenintensive E/A-Vorgänge auszuführen, ohne den Hauptthread zu blockieren. Diese Leistungsüberlegung ist in einer Windows Store App oder in Desktop App besonders wichtig, in der ein zeitaufwendiger Streamvorgang den UI-Thread blockieren und die App angezeigt werden kann, als ob er nicht funktioniert. Die asynchrone Methoden werden in Verbindung mit den async und await Schlüsselwörtern in Visual Basic und C# verwendet.

Wenn es in einer Windows Store App verwendet wird, enthält Stream zwei Erweiterungsmethoden ein: AsInputStream und AsOutputStream. Diese Methoden konvertieren Stream ein Objekt in einem Stream in Windows-Runtime. Sie können einen Stream in Windows-Runtime zu einem Stream-Objekt konvertieren, indem Sie die AsStreamForRead und AsStreamForWrite-Methoden ausführen.

Einige der Implementierungen von Streams speichern die zugrunde liegenden Daten lokal im Puffer, um die Leistung zu verbessern. Für solche Streams können Sie die Flush oder FlushAsync-Methode verwenden, um alle internen Puffer zu löschen und sicherzustellen, dass alle Daten der zugrunde liegenden Datenquelle oder das Repository geschrieben wurden.

Das Verwerfen eines Objekts Stream leert alle gepufferten Daten und ruft praktisch die Flush-Methode auf. Dispose gibt auch Betriebssystemressourcen z. B. Dateihandles, Netzwerkverbindungen oder den Arbeitsspeicher frei, der für eine interne Pufferung verwendet wurde. Durch die BufferedStream-Klasse kann ein gepufferter Stream Wrapper eines anderen Streams werden, sodass die Lese- und Schreibleistung verbessert wird.

Wenn Sie einen Stream ohne Sicherungsspeicher (auch als Bitbucket) benötigen, verwenden Sie das Null Feld, um eine Instanz eines Streams abzurufen, der zu diesem Zweck entworfen wurde.

Wenn Sie eine abgeleitete Klasse Stream implementieren, müssen Sie Implementierungen für die Read und Write-Methoden bereitstellen. Die asynchronen Methoden ReadAsync, WriteAsync und CopyToAsync verwendet die synchronen Methoden Read und Write in ihren Implementierungen. Daher eignen sich die Implementierungen von Read und von Write ordnungsgemäß mit den asynchronen Methoden. In den Standardimplementierungen von ReadByte und WriteByte wird ein neues, aus einem Element bestehendes Bytearray erstellt und anschließend die Implementierung der Read-Methode und der Write-Methode aufgerufen. Wenn Sie von Stream abgeleitet werden, wird empfohlen, diese Methoden überschreiben, um auf den internen Puffer, wenn Sie ein verfügen, für erheblich auf die Leistung verbessert. Stellen Sie Implementierungen von CanRead, CanSeek, CanWrite, Flush, Length, Position, Seek und SetLength bereit.

Überschreiben Sie die - Methode nicht Close, legen Sie stattdessen die ganze Stream Bereinigungslogik in die Dispose-Methode ein. Weitere Informationen finden Sie unter Implementieren einer Dispose-Methode.

Das folgende Beispiel zeigt, wie zwei FileStream-Objekte verwendet, um die Dateien aus einem Verzeichnis in ein anderes Verzeichnis asynchron zu kopieren. Die FileStream-Klasse wird aus der Stream-Klasse abgeleitet. Beachten Sie, dass der Click-Ereignishandler für das - Steuerelement Buttonasync mit dem - Modifizierer gekennzeichnet ist, da er eine asynchrone Methode aufruft

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

Portable Klassenbibliothek

.NET für Windows Store-Apps

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz

Weitere Ressourcen