Freigeben über


MemoryStream-Konstruktor (Byte , Int32, Int32, Boolean)

Initialisiert anhand des angegebenen Bereichs eines Bytearrays eine neue Instanz der MemoryStream-Klasse, deren Größe nicht geändert werden kann, wobei die CanWrite-Eigenschaft wie angegeben festgelegt wird.

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

Syntax

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

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

Parameter

  • buffer
    Das Array vorzeichenloser Bytes, aus dem dieser Stream erstellt werden soll.
  • index
    Der Index in buffer, bei dem der Stream beginnt.
  • count
    Die Länge des Streams in Bytes.
  • writable
    Die Einstellung der CanWrite-Eigenschaft, mit der bestimmt wird, ob der Stream Schreibvorgänge unterstützt.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

buffer ist NULL (Nothing in Visual Basic).

ArgumentOutOfRangeException

index oder count ist negativ.

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 und die CanSeek-Eigenschaft sind beide auf true festgelegt. 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, wenn writabletrue ist.

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