Stream Klasse

Definition

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

Vererbung

Object

Stream

Vererbung

Object

MarshalByRefObject

Stream

Abgeleitet

Microsoft.JScript.COMCharStream

System.Data.OracleClient.OracleBFile

System.Data.OracleClient.OracleLob

System.Data.SqlTypes.SqlFileStream

System.IO.BufferedStream

Mehr …

Attribute

SerializableAttribute ComVisibleAttribute

Implementiert

IDisposable IAsyncDisposable

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Zwei FileStream Objekte verwendet werden, um die Dateien asynchron aus einem Verzeichnis in ein anderes Verzeichnis zu kopieren. Die FileStream Klasse wird von der Stream Klasse abgeleitet. Beachten Sie, dass der Click Ereignishandler für das Button-Steuerelement mit dem async 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);
                    }
                }
            }
        }
    }
}

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

Hinweise

Stream ist die abstrakte Basisklasse aller Datenströme. Ein Datenstrom ist eine Abstraktion einer Bytesequenz, z. B. einer Datei, eines Eingabe-/Ausgabegeräts, einer prozessübergreifenden Kommunikationspipeline oder eines TCP/IP-Sockets. Die Stream Klasse und die abgeleiteten Klassen bieten eine allgemeine Ansicht dieser verschiedenen Eingabe- und Ausgabetypen und isolieren den Programmierer anhand der spezifischen Details des Betriebssystems und der zugrunde liegenden Geräte.

Datenströme umfassen drei grundlegende Vorgänge:

• Sie können aus Datenströmen lesen. Das Lesen ist die Übertragung von Daten aus einem Datenstrom in eine Datenstruktur, z. B. ein Bytearray.

• Sie können in Datenströme schreiben. Das Schreiben ist die Übertragung von Daten aus einer Datenstruktur in einen Datenstrom.

• Streams können die Suche unterstützen. Suche bezieht sich auf Abfragen und Ändern der aktuellen Position innerhalb eines Datenstroms. Die Suchfunktion hängt von der Art des Sicherungsspeichers ab, über den ein Datenstrom verfügt. Beispielsweise haben Netzwerkdatenströme kein einheitliches Konzept einer aktuellen Position und unterstützen daher in der Regel keine Suche.

Einige der häufiger verwendeten Datenströme, die von Stream erben, sind FileStreamund MemoryStream.

Je nach zugrunde liegender Datenquelle oder Repository unterstützen Datenströme möglicherweise nur einige dieser Funktionen. Sie können einen Datenstrom nach seinen Funktionen abfragen, indem Sie die Eigenschaften CanRead, CanWriteund CanSeek der Stream Klasse verwenden.

Die methoden Read und Write lesen und schreiben Daten in einer Vielzahl von Formaten. Verwenden Sie für Datenströme, die die Suche unterstützen, die Methoden Seek und SetLength sowie die eigenschaften Position und Length, um die aktuelle Position und Länge eines Datenstroms abzufragen und zu ändern.

Dieser Typ implementiert die IDisposable Schnittstelle. Wenn Sie die Verwendung des Typs abgeschlossen haben, sollten Sie ihn entweder direkt oder indirekt verwerfen. Rufen Sie zum direkten Löschen des Typs die Dispose-Methode in einem try/catch-Block auf. Verwenden Sie zum indirekten Löschen ein Sprachkonstrukt wie using (in C#) oder Using (in Visual Basic). Weitere Informationen finden Sie im Abschnitt "Verwenden eines Objekts, das IDisposable implementiert", im Thema zur IDisposable Schnittstelle.

Durch das Löschen eines Stream Objekts werden alle gepufferten Daten geleert, und im Wesentlichen wird die Flush Methode für Sie aufgerufen. Dispose gibt auch Betriebssystemressourcen wie Dateihandles, Netzwerkverbindungen oder Arbeitsspeicher frei, die für interne Pufferung verwendet werden. Die BufferedStream-Klasse bietet die Möglichkeit, einen gepufferten Datenstrom um einen anderen Datenstrom umzuschließen, um die Lese- und Schreibleistung zu verbessern.

Ab .NET Framework 4.5 enthält die Stream-Klasse asynchrone Methoden, um asynchrone Vorgänge zu vereinfachen. Eine asynchrone Methode enthält Async in ihrem Namen, z. B. ReadAsync, WriteAsync, CopyToAsyncund FlushAsync. Mit diesen Methoden können Sie ressourcenintensive E/A-Vorgänge ausführen, ohne den Hauptthread zu blockieren. Diese Leistungsüberlegung ist in einer Windows 8.x Store-App oder Desktop-App besonders wichtig, bei der ein zeitaufwendiger Streamvorgang den UI-Thread blockieren und ihre App so erscheinen lässt, als ob sie nicht funktioniert. Die asynchronen Methoden werden in Verbindung mit den schlüsselwörtern async und await in Visual Basic und C# verwendet.

Bei Verwendung in einer Windows 8.x Store-App umfasst Stream zwei Erweiterungsmethoden: AsInputStream und AsOutputStream. Diese Methoden konvertieren ein Stream-Objekt in einen Datenstrom in der Windows-Runtime. Sie können einen Datenstrom in der Windows-Runtime auch mithilfe der methoden AsStreamForRead und AsStreamForWrite in ein Stream-Objekt konvertieren. Weitere Informationen finden Sie unter How to: Convert Between .NET Framework Streams and Windows Runtime Streams

Einige Streamimplementierungen führen lokale Pufferung der zugrunde liegenden Daten durch, um die Leistung zu verbessern. Für solche Datenströme können Sie die Flush- oder FlushAsync-Methode verwenden, um alle internen Puffer zu löschen und sicherzustellen, dass alle Daten in die zugrunde liegende Datenquelle oder das zugrunde liegende Repository geschrieben wurden.

Wenn Sie einen Datenstrom ohne Sicherungsspeicher (auch als Bit-Bucket bezeichnet) benötigen, verwenden Sie das feld Null, um eine Instanz eines Datenstroms abzurufen, der für diesen Zweck entwickelt wurde.

Hinweise für Ausführende

Wenn Sie eine abgeleitete Klasse von Streamimplementieren, müssen Sie Implementierungen für die methoden Read(Byte[], Int32, Int32) und Write(Byte[], Int32, Int32) bereitstellen. Die asynchronen Methoden ReadAsync(Byte[], Int32, Int32), WriteAsync(Byte[], Int32, Int32)und CopyToAsync(Stream) verwenden die synchronen Methoden Read(Byte[], Int32, Int32) und Write(Byte[], Int32, Int32) in ihren Implementierungen. Daher funktionieren Ihre Implementierungen von Read(Byte[], Int32, Int32) und Write(Byte[], Int32, Int32) ordnungsgemäß mit den asynchronen Methoden. Die Standardimplementierungen von ReadByte() und WriteByte(Byte) ein neues Bytearray mit einem einzelnen Element erstellen und dann Ihre Implementierungen von Read(Byte[], Int32, Int32) und Write(Byte[], Int32, Int32)aufrufen. Wenn Sie von Streamabgeleitet werden, empfiehlt es sich, diese Methoden außer Kraft zu setzen, um auf ihren internen Puffer zuzugreifen, falls vorhanden, um eine wesentlich bessere Leistung zu erzielen. Sie müssen auch Implementierungen von CanRead, CanSeek, CanWrite, Flush(), Length, Position, Seek(Int64, SeekOrigin)und SetLength(Int64).

Setzen Sie stattdessen nicht die Close()-Methode außer Kraft, fügen Sie stattdessen alle Stream Bereinigungslogik in die Dispose(Boolean)-Methode ein. Weitere Informationen finden Sie unter Implementieren einer Dispose-Methode.

Konstruktoren

Felder

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Erweiterungsmethoden

Gilt für:

Weitere Informationen

• FileStream
• MemoryStream
• BufferedStream
• Datei- und Stream-E/A-
• Vorgehensweise: Konvertieren zwischen .NET Framework-Streams und Windows-Runtime-Streams