MemoryStream.GetBuffer MemoryStream.GetBuffer MemoryStream.GetBuffer MemoryStream.GetBuffer Method

Definition

Gibt das Array vorzeichenloser Bytes zurück, aus dem dieser Stream erstellt wurde.Returns the array of unsigned bytes from which this stream was created.

public:
 virtual cli::array <System::Byte> ^ GetBuffer();
public virtual byte[] GetBuffer ();
abstract member GetBuffer : unit -> byte[]
override this.GetBuffer : unit -> byte[]
Public Overridable Function GetBuffer () As Byte()

Gibt zurück

Byte[]

Das Bytearray, aus dem der Stream erstellt wurde, oder das zugrunde liegende Array, wenn für den MemoryStream-Konstruktor beim Erstellen der aktuellen Instanz kein Bytearray bereitgestellt wurde.The byte array from which this stream was created, or the underlying array if a byte array was not provided to the MemoryStream constructor during construction of the current instance.

Ausnahmen

Die MemoryStream-Instanz wurde nicht mit einem öffentlich sichtbaren Puffer erstellt.The MemoryStream instance was not created with a publicly visible buffer.

Hinweise

Beachten Sie, dass der Puffer zugeordneten Bytes enthält möglicherweise nicht verwendet.Note that the buffer contains allocated bytes which might be unused. Angenommen, in die Zeichenfolge "Test" geschrieben wird die MemoryStream -Objekt, das die Länge des Puffers Merry GetBuffer beträgt 256 Bytes und nicht auf 4, mit 252 Byte, die nicht verwendete.For example, if the string "test" is written into the MemoryStream object, the length of the buffer returned from GetBuffer is 256, not 4, with 252 bytes unused. Um nur die Daten in den Puffer zu erhalten, verwenden die ToArray Methode jedoch ToArray erstellt eine Kopie der Daten im Arbeitsspeicher.To obtain only the data in the buffer, use the ToArray method; however, ToArray creates a copy of the data in memory.

Der Puffer kann auch sein, null.The buffer can also be null.

Zum Erstellen einer MemoryStream -Instanz mit einem öffentlich sichtbaren Puffer, Verwendung MemoryStream, MemoryStream(Byte[], Int32, Int32, Boolean, Boolean), oder MemoryStream(Int32).To create a MemoryStream instance with a publicly visible buffer, use MemoryStream, MemoryStream(Byte[], Int32, Int32, Boolean, Boolean), or MemoryStream(Int32). Wenn der aktuelle Stream in der Größe veränderbar ist, geben zwei Aufrufe dieser Methode nicht dasselbe Array zurück, wenn das zugrunde liegende Bytearray zwischen Aufrufen geändert wird.If the current stream is resizable, two calls to this method do not return the same array if the underlying byte array is resized between calls. Weitere Informationen finden Sie unter Capacity.For additional information, see Capacity.

Hinweis

Diese Methode funktioniert, wenn der arbeitsspeicherdatenstrom geschlossen wird.This method works when the memory stream is closed.

Gilt für:

Siehe auch