MemoryStream Konstruktoren

Definition

Namespace:

System.IO

Assembly:

System.IO.dll

Assembly:

System.Runtime.dll

Assembly:

System.Runtime.Extensions.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Initialisiert eine neue Instanz der MemoryStream-Klasse.

Überlädt

MemoryStream()	Initialisiert eine neue Instanz der MemoryStream-Klasse mit einer erweiterbaren Kapazität, die mit 0 (null) initialisiert wurde.
MemoryStream(Byte[])	Initialisiert anhand des angegebenen Bytearrays eine neue Instanz der MemoryStream-Klasse, deren Größe nicht geändert werden kann.
MemoryStream(Int32)	Initialisiert eine neue Instanz der MemoryStream-Klasse mit einer erweiterbaren Kapazität, die mit dem angegebenen Wert initialisiert wird.
MemoryStream(Byte[], Boolean)	Initialisiert anhand des angegebenen Bytearrays eine neue Instanz der MemoryStream-Klasse, deren Größe nicht geändert werden kann, wobei die CanWrite-Eigenschaft wie angegeben festgelegt wird.
MemoryStream(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.
MemoryStream(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 wurde.
MemoryStream(Byte[], Int32, Int32, Boolean, Boolean)	Initialisiert eine neue Instanz der MemoryStream-Klasse auf der Grundlage des angegebenen Bereichs eines Bytearrays, wobei die CanWrite-Eigenschaft und die Möglichkeit zum Aufruf von GetBuffer() wie angegeben festgelegt werden.

MemoryStream()

Initialisiert eine neue Instanz der MemoryStream-Klasse mit einer erweiterbaren Kapazität, die mit 0 (null) initialisiert wurde.

public:
 MemoryStream();

public MemoryStream ();

Public Sub New ()

Hinweise

Die CanReadEigenschaften , CanSeekund CanWrite Eigenschaften sind auf true"festgelegt" festgelegt.

Die Kapazität des aktuellen Datenstroms wird automatisch erhöht, wenn Sie die Methode verwenden SetLength , um die Länge auf einen Wert festzulegen, der größer als die Kapazität des aktuellen Datenstroms ist.

Dieser Konstruktor macht den zugrunde liegenden Datenstrom verfügbar, der GetBuffer zurückgibt.

Siehe auch

• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

MemoryStream(Byte[])

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

public:
 MemoryStream(cli::array <System::Byte> ^ buffer);

public MemoryStream (byte[] buffer);

new System.IO.MemoryStream : byte[] -> System.IO.MemoryStream

Public Sub New (buffer As Byte())

Parameter

buffer

Byte[]

Das Array vorzeichenloser Bytes, aus dem der aktuelle Stream erstellt werden soll.

Ausnahmen

ArgumentNullException

buffer ist null.

Hinweise

Die CanReadEigenschaften , CanSeekund CanWrite Eigenschaften sind auf true"festgelegt" festgelegt. Capacity wird auf die Länge des angegebenen Bytearrays festgelegt. Der neue Stream kann in geschrieben werden, ist jedoch nicht möglich.

Die Länge des Datenstroms 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 Datenstrom nicht verfügbar. GetBuffer wird ausgelöst UnauthorizedAccessException.

Siehe auch

• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

MemoryStream(Int32)

Initialisiert eine neue Instanz der MemoryStream-Klasse mit einer erweiterbaren Kapazität, die mit dem angegebenen Wert initialisiert wird.

public:
 MemoryStream(int capacity);

public MemoryStream (int capacity);

new System.IO.MemoryStream : int -> System.IO.MemoryStream

Public Sub New (capacity As Integer)

Parameter

capacity

Int32

Die Anfangsgröße des internen Arrays in Bytes.

Ausnahmen

ArgumentOutOfRangeException

capacity ist ein negativer Wert.

Beispiele

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die MemoryStream-Klasse bereitgestellt wird.

MemoryStream^ memStream = gcnew MemoryStream( 100 );

using(MemoryStream memStream = new MemoryStream(100))

Dim memStream As New MemoryStream(100)

Hinweise

Die CanReadEigenschaften , CanSeekund CanWrite Eigenschaften sind auf true"festgelegt" festgelegt.

Die Kapazität erhöht sich automatisch, wenn Sie die Methode verwenden, um die Länge auf einen Wert festzulegen, der SetLength größer als die Kapazität des aktuellen Datenstroms ist. Mit Ausnahme eines MemoryStream mit einem Byte[]-Parameter erstellten Parameters schreiben Sie Vorgänge am Ende einer MemoryStream Erweiterung MemoryStream.

Dieser Konstruktor stellt den zugrunde liegenden Datenstrom zur Verfügung, der GetBuffer zurückgegeben wird.

Siehe auch

• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

MemoryStream(Byte[], Boolean)

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

public:
 MemoryStream(cli::array <System::Byte> ^ buffer, bool writable);

public MemoryStream (byte[] buffer, bool writable);

new System.IO.MemoryStream : byte[] * bool -> System.IO.MemoryStream

Public Sub New (buffer As Byte(), writable As Boolean)

Parameter

buffer

Byte[]

Das Array vorzeichenloser Bytes, aus dem dieser Stream erstellt werden soll.

writable

Boolean

Die Einstellung der CanWrite-Eigenschaft, mit der bestimmt wird, ob der Stream Schreibvorgänge unterstützt.

Ausnahmen

ArgumentNullException

buffer ist null.

Hinweise

CanSeek Die CanRead Eigenschaften sind sowohl auf " festgelegt" als auch auf true". Capacity wird auf die Länge des angegebenen Bytearrays festgelegt.

Die Länge des Datenstroms 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 Datenstrom nicht verfügbar. GetBuffer wird ausgelöst UnauthorizedAccessException.

Siehe auch

• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

MemoryStream(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.

public:
 MemoryStream(cli::array <System::Byte> ^ buffer, int index, int count);

public MemoryStream (byte[] buffer, int index, int count);

new System.IO.MemoryStream : byte[] * int * int -> System.IO.MemoryStream

Public Sub New (buffer As Byte(), index As Integer, count As Integer)

Parameter

buffer

Byte[]

Das Array vorzeichenloser Bytes, aus dem dieser Stream erstellt werden soll.

index

Int32

Der Index in buffer, an dem der Stream beginnt.

count

Int32

Die Länge des Streams in Bytes.

Ausnahmen

ArgumentNullException

buffer ist null.

ArgumentOutOfRangeException

index oder count ist kleiner als 0.

ArgumentException

Die Pufferlänge minus index ist kleiner als count.

Hinweise

Die Eigenschaften und CanWrite CanSeekEigenschaften sind alle auf truefestgelegt, aber die CanReadKapazität kann nicht geändert werden. Für Capacity ist count festgelegt.

Die Länge des Datenstroms 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 Datenstrom nicht verfügbar. GetBuffer wird ausgelöst UnauthorizedAccessException. Sie können jedoch im Stream schreiben.

Siehe auch

• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

MemoryStream(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 wurde.

public:
 MemoryStream(cli::array <System::Byte> ^ buffer, int index, int count, bool writable);

public MemoryStream (byte[] buffer, int index, int count, bool writable);

new System.IO.MemoryStream : byte[] * int * int * bool -> System.IO.MemoryStream

Public Sub New (buffer As Byte(), index As Integer, count As Integer, writable As Boolean)

Parameter

buffer

Byte[]

Das Array vorzeichenloser Bytes, aus dem dieser Stream erstellt werden soll.

index

Int32

Der Index in buffer, bei dem der Stream beginnt.

count

Int32

Die Länge des Streams in Bytes.

writable

Boolean

Die Einstellung der CanWrite-Eigenschaft, mit der bestimmt wird, ob der Stream Schreibvorgänge unterstützt.

Ausnahmen

ArgumentNullException

buffer ist null.

ArgumentOutOfRangeException

index oder count ist negativ.

ArgumentException

Die Pufferlänge minus index ist kleiner als count.

Hinweise

CanSeek Die CanRead Eigenschaften sind sowohl auf " festgelegt" als auch auf true". Für Capacity ist count festgelegt.

Die Länge des Datenstroms 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 Datenstrom nicht verfügbar. GetBuffer wird ausgelöst UnauthorizedAccessException. Sie können jedoch in den Datenstrom schreiben, wenn writable es sich um einen Vorgang handelt true.

Siehe auch

• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

MemoryStream(Byte[], Int32, Int32, Boolean, Boolean)

Initialisiert eine neue Instanz der MemoryStream-Klasse auf der Grundlage des angegebenen Bereichs eines Bytearrays, wobei die CanWrite-Eigenschaft und die Möglichkeit zum Aufruf von GetBuffer() wie angegeben festgelegt werden.

public:
 MemoryStream(cli::array <System::Byte> ^ buffer, int index, int count, bool writable, bool publiclyVisible);

public MemoryStream (byte[] buffer, int index, int count, bool writable, bool publiclyVisible);

new System.IO.MemoryStream : byte[] * int * int * bool * bool -> System.IO.MemoryStream

Public Sub New (buffer As Byte(), index As Integer, count As Integer, writable As Boolean, publiclyVisible As Boolean)

Parameter

buffer

Byte[]

Das Array vorzeichenloser Bytes, aus dem dieser Stream erstellt werden soll.

index

Int32

Der Index in buffer, an dem der Stream beginnt.

count

Int32

Die Länge des Streams in Bytes.

writable

Boolean

Die Einstellung der CanWrite-Eigenschaft, mit der bestimmt wird, ob der Stream Schreibvorgänge unterstützt.

publiclyVisible

Boolean

true, um GetBuffer() zu aktivieren, wodurch das Array vorzeichenloser Bytes zurückgegeben wird, aus dem der Stream erstellt wurde, andernfalls false.

Ausnahmen

ArgumentNullException

buffer ist null.

ArgumentOutOfRangeException

index oder count ist ein negativer Wert.

ArgumentException

Die Pufferlänge minus index ist kleiner als count.

Hinweise

CanSeek Die CanRead Eigenschaften sind sowohl auf " festgelegt" als auch auf true". Für Capacity ist count festgelegt.

Die neue Streaminstanz kann in geschrieben werden, aber das Capacity zugrunde liegende Bytearray kann nicht geändert werden. Die Länge des Datenstroms 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).

Siehe auch

• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei