Freigeben über


MemoryStream-Konstruktor (Byte , Int32, Int32)

Initialisiert anhand des angegebenen Bereichs (Indexes) eines Bytearrays eine neue Instanz der MemoryStream-Klasse, deren Größe nicht geändert werden kann.

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Sub New ( _
    buffer As Byte(), _
    index As Integer, _
    count As Integer _
)
'Usage
Dim buffer As Byte()
Dim index As Integer
Dim count As Integer

Dim instance As New MemoryStream(buffer, index, count)
public MemoryStream (
    byte[] buffer,
    int index,
    int count
)
public:
MemoryStream (
    array<unsigned char>^ buffer, 
    int index, 
    int count
)
public MemoryStream (
    byte[] buffer, 
    int index, 
    int count
)
public function MemoryStream (
    buffer : byte[], 
    index : int, 
    count : int
)

Parameter

  • buffer
    Das Array vorzeichenloser Bytes, aus dem dieser Stream erstellt werden soll.
  • index
    Der Index in buffer, an dem der Stream beginnt.
  • count
    Die Länge des Streams in Bytes.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

buffer ist NULL (Nothing in Visual Basic).

ArgumentOutOfRangeException

index oder count ist kleiner als 0.

ArgumentException

Die Summe aus index und count ist größer als die Länge von buffer.

Hinweise

Ein Beispiel für das Erstellen einer Datei und das Schreiben von Text in eine Datei finden Sie unter Gewusst wie: Schreiben von Text in eine Datei. Ein Beispiel für das Lesen von Text aus einer Datei finden Sie unter Gewusst wie: Lesen aus einer Textdatei. Ein Beispiel für das Lesen aus einer Binärdatei und das Schreiben in eine Binärdatei finden Sie unter Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei.

Die CanRead-Eigenschaft, die CanSeek-Eigenschaft und die CanWrite-Eigenschaft ist jeweils auf true festgelegt, jedoch kann die Kapazität kann geändert werden. Capacity ist auf count festgelegt.

Die Länge des Streams kann nicht auf einen Wert festgelegt werden, der größer als die anfängliche Länge des angegebenen Bytearrays ist. Der Stream kann jedoch abgeschnitten werden (siehe SetLength).

Dieser Konstruktor macht den zugrunde liegenden Stream nicht verfügbar. GetBuffer löst UnauthorizedAccessException aus. Sie können jedoch in den Stream schreiben.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

MemoryStream-Klasse
MemoryStream-Member
System.IO-Namespace

Weitere Ressourcen

Datei- und Stream-E/A
Gewusst wie: Lesen aus einer Textdatei
Gewusst wie: Schreiben von Text in eine Datei