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.Extensions.AI.HostedFileDownloadStream

Microsoft.JScript.COMCharStream

System.Data.OracleClient.OracleBFile

System.Data.OracleClient.OracleLob

System.Data.SqlTypes.SqlFileStream

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 generische 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 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 CanReadCanWriteEigenschaften und CanSeek Eigenschaften der Stream Klasse verwenden.

Die Read Methoden Write lesen und schreiben Daten in einer Vielzahl von Formaten. Verwenden Sie für Datenströme, die die Suche unterstützen, die Seek Methoden und SetLength Die PositionLength Eigenschaften, 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 die Methode Dispose in einem try/catch-Block auf, um den Typ direkt zu entsorgen. 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 IDisposable Schnittstellenthema.

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 alle internen Puffer 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 ihren Namen, z ReadAsync. B. , , 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 in Visual Basic und C# await verwendet.

Bei Verwendung in einer Windows 8.x Store-App Stream sind zwei Erweiterungsmethoden enthalten: 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 und AsStreamForWrite der AsStreamForRead Methoden 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 die 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 Null Feld, 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 Read(Byte[], Int32, Int32) und Write(Byte[], Int32, Int32) Methoden 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) funktionieren ordnungsgemäß mit den asynchronen Methoden. Die Standardimplementierungen von ReadByte() und WriteByte(Byte) erstellen ein neues Bytearray mit einem einzelnen Element, und rufen Sie dann Ihre Implementierungen von Read(Byte[], Int32, Int32) und auf Write(Byte[], Int32, Int32). Wenn Sie von Streamdieser Ableitung abgeleitet werden, empfehlen wir, diese Methoden außer Kraft zu setzen, um auf ihren internen Puffer zuzugreifen, falls vorhanden, um eine wesentlich bessere Leistung zu erzielen. Außerdem müssen Sie Implementierungen von CanRead, , CanSeek, CanWriteFlush(), , Length, Positionund Seek(Int64, SeekOrigin)SetLength(Int64).

Setzen Sie stattdessen nicht die Close()Stream gesamte Bereinigungslogik in die Dispose(Boolean) Methode außer Kraft. Weitere Informationen finden Sie unter Implementieren einer Dispose-Methode.

Weitere Informationen

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