MemoryStream.GetBuffer Method
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
Returns the array of unsigned bytes from which this stream was created.
Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)
Return Value
Type: System.Byte[]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.
| Exception | Condition |
|---|---|
| UnauthorizedAccessException |
The MemoryStream instance was not created with a publicly visible buffer. |
Note that the buffer contains allocated bytes which might be unused. 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. To obtain only the data in the buffer, use the ToArray method; however, ToArray creates a copy of the data in memory.
The buffer can also be null.
To create a MemoryStream instance with a publicly visible buffer, use MemoryStream, MemoryStream(Byte[], Int32, Int32, Boolean, Boolean), or MemoryStream(Int32). 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. For additional information, see Capacity.
Note
|
|---|
|
This method works when the memory stream is closed. |
Windows 8 Release Preview, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 SP2, Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
