Stream.ReadByte メソッド

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

Stream.ReadByte メソッド

ストリームから 1 バイトを読み取り、ストリーム内の位置を 1 バイト進めます。ストリームの末尾の場合は -1 を返します。

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

Visual Basic (宣言)

Public Overridable Function
 ReadByte As Integer

Visual Basic (使用法)

Dim instance As Stream
Dim returnValue As Integer

returnValue = instance.ReadByte

C#

public virtual int ReadByte ()

C++

public:
virtual int ReadByte ()

J#

public int ReadByte ()

JScript

public function ReadByte () : int

戻り値
Int32 にキャストされた符号なしバイト。ストリームの末尾の場合は -1。

例外

例外の種類	条件
NotSupportedException	ストリームが読み取りをサポートしていません。
ObjectDisposedException	ストリームが閉じられた後でメソッドが呼び出されました。

解説

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

現在のインスタンスが読み取りをサポートしているかどうかを判断するには、CanRead プロパティを使用します。

ストリームが閉じられた後で、そのストリームを操作しようとすると ObjectDisposedException がスローされる場合があります。

実装時の注意 Stream に対する既定の実装は、新しい 1 バイト配列を作成してから Read を呼び出します。このメソッドは正式には正しいのですが、効率的ではありません。内部バッファを備えたストリームは、このメソッドをオーバーライドし、直接バッファを読み込むはるかに効率的なバージョンを提供します。これにより、呼び出しのたびに不要な配列割り当てが行われるのを避けることができます。

プラットフォーム

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

参照

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