Stream.ReadByte メソッド

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

ソース:

Stream.cs

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

public:
 virtual int ReadByte();

public virtual int ReadByte ();

abstract member ReadByte : unit -> int
override this.ReadByte : unit -> int

Public Overridable Function ReadByte () As Integer

戻り値

Int32

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

例外

NotSupportedException

ストリームは読み取りをサポートしません。

ObjectDisposedException

ストリームが閉じた後でメソッドが呼び出されました。

注釈

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

ストリームが閉じられた後にストリームを操作しようとすると、 がスローされる ObjectDisposedException可能性があります。

注意 (継承者)

の既定の実装 Stream では、新しい 1 バイト配列が作成され、 が呼び出 Read(Byte[], Int32, Int32)されます。 これは正式には正しいですが、非効率的です。 内部バッファーを含むストリームでは、このメソッドをオーバーライドし、バッファーを直接読み取るより効率的なバージョンを提供する必要があります。これにより、すべての呼び出しで余分な配列割り当てが回避されます。

こちらもご覧ください

• ファイルおよびストリーム入出力
• 方法: ファイルからのテキストの読み取り
• 方法: テキストのファイルへの書き込み