MemoryStream.GetBuffer Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt das Array vorzeichenloser Bytes zurück, aus dem dieser Stream erstellt wurde.
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
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.
Ausnahmen
Die MemoryStream
-Instanz wurde nicht mit einem öffentlich sichtbaren Puffer erstellt.
Hinweise
Beachten Sie, dass der Puffer zugeordnete Bytes enthält, die möglicherweise nicht verwendet werden. Wenn beispielsweise die Zeichenfolge "test" in das MemoryStream -Objekt geschrieben wird, beträgt die Länge des von GetBuffer zurückgegebenen Puffers 256, nicht 4, wobei 252 Bytes nicht verwendet werden. Um nur die Daten im Puffer abzurufen, verwenden Sie die ToArray -Methode. ToArray Erstellt jedoch eine Kopie der Daten im Arbeitsspeicher.
Der Puffer kann auch sein null
.
Um eine MemoryStream
instance mit einem öffentlich sichtbaren Puffer zu erstellen, verwenden Sie MemoryStream, MemoryStream(Byte[], Int32, Int32, Boolean, Boolean)oder MemoryStream(Int32). Wenn der aktuelle Stream veränderbar ist, geben zwei Aufrufe dieser Methode nicht das gleiche Array zurück, wenn die Größe des zugrunde liegenden Bytearrays zwischen Aufrufen geändert wird. Weitere Informationen finden Sie unter Capacity.
Hinweis
Diese Methode funktioniert, wenn der Speicherdatenstrom geschlossen wird.