MemoryStream.GetBuffer メソッド

.NET Framework クラス ライブラリ リファレンス

MemoryStream.GetBuffer メソッド

このストリームの作成元の符号なしバイトの配列を返します。

名前空間: System.IO
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 GetBuffer As Byte()

Visual Basic (使用法)

Dim instance As MemoryStream
Dim returnValue As Byte()

returnValue = instance.GetBuffer

C#

public virtual byte[] GetBuffer ()

C++

public:
virtual array<unsigned char>^ GetBuffer ()

J#

public byte[] GetBuffer ()

JScript

public function GetBuffer () : byte[]

戻り値
このストリームの作成に使用したバイト配列。現在のインスタンスを構築するときに、MemoryStream コンストラクタにバイト配列が提供されなかった場合は、基になる配列。

例外

例外の種類	条件
UnauthorizedAccessException	パブリックに参照できるバッファを持つ MemoryStream インスタンスが作成されませんでした。

解説

ファイルの作成およびテキストのファイルへの書き込みの例については、「方法 : ファイルにテキストを書き込む」を参照してください。ファイルからのテキストの読み取りの例については、「方法 : ファイルからテキストを読み取る」を参照してください。バイナリ ファイルの読み取りおよび書き込みの例については、「方法 : 新しく作成されたデータ ファイルに対して読み書きする」を参照してください。

バッファには、使用されない可能性のある割り当て済みのバイトも含まれます。たとえば、文字列 "test" が MemoryStream オブジェクトに書き込まれる場合、252 バイトは未使用であっても、GetBuffer から返されるバッファの長さは 4 ではなく 256 になります。バッファ内のデータだけを取得するには、ToArray メソッドを使用します。ただし、ToArray は、メモリ内のデータのコピーを作成します。

パブリックに参照できるバッファを持つ MemoryStream インスタンスを作成するには、MemoryStream、MemoryStream(Byte[],Int32,Int32,Boolean,Boolean)、または MemoryStream(Int32) を使用します。現在のストリームのサイズを変更できる場合に、このメソッドを 2 回呼び出しても、メソッド呼び出しの間に基になるバイト配列のサイズが変更されると、同じ配列は返されません。詳細については、Capacity のトピックを参照してください。

メモ
このメソッドは、メモリ ストリームが閉じられているときに機能します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
MemoryStream クラス
MemoryStream メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む