Stream.ReadByte メソッド

定義

ストリームから 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。

例外

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

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

注釈

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

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

注意 (継承者)

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

適用対象

こちらもご覧ください