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

定義

このストリームの作成元の符号なしバイトの配列を返します。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()

戻り値

Byte[]

このストリームの作成に使用したバイト配列。現在のインスタンスを構築するときに、MemoryStream コンストラクターにバイト配列が提供されなかった場合は、基になる配列。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.

例外

パブリックに参照できるバッファーを持つ MemoryStream インスタンスが作成されませんでした。The MemoryStream instance was not created with a publicly visible buffer.

注釈

バッファーには未使用の割り当て済みバイトが含まれていることに注意してください。Note that the buffer contains allocated bytes which might be unused. たとえば、文字列 "test" がMemoryStreamオブジェクトに書き込まれた場合、からGetBuffer返されるバッファーの長さは、4ではなく256であり、252バイトは使用されません。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. バッファー内のデータのみを取得するには、 ToArrayメソッドを使用しToArrayます。ただし、では、データのコピーがメモリに作成されます。To obtain only the data in the buffer, use the ToArray method; however, ToArray creates a copy of the data in memory.

バッファーもにするnullことができます。The buffer can also be null.

パブリックに参照MemoryStreamできるバッファーを持つインスタンスを作成するにMemoryStream(Byte[], Int32, Int32, Boolean, Boolean)は、 MemoryStream(Int32)、、またはを使用MemoryStreamします。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. 詳細については、「Capacity」を参照してください。For additional information, see Capacity.

注意

このメソッドは、メモリストリームが閉じられたときに機能します。This method works when the memory stream is closed.

適用対象

こちらもご覧ください