Stream.ReadByte Stream.ReadByte Stream.ReadByte Stream.ReadByte Method

定義

ストリームから 1 バイトを読み取り、ストリーム内の位置を 1 バイト進めます。ストリームの末尾の場合は -1 を返します。 Reads a byte from the stream and advances the position within the stream by one byte, or returns -1 if at the end of the stream.

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 にキャストされた符号なしバイト。ストリームの末尾の場合は -1。 The unsigned byte cast to an Int32, or -1 if at the end of the stream.

例外

ストリームは読み取りをサポートしません。 The stream does not support reading.

ストリームが閉じた後でメソッドが呼び出されました。 Methods were called after the stream was closed.

注釈

使用して、CanReadプロパティを現在のインスタンスが読み取りをサポートするかどうかを判断します。Use the CanRead property to determine whether the current instance supports reading.

ストリームが閉じられた後、ストリームを操作しようとすると、ObjectDisposedExceptionします。Attempts to manipulate the stream after the stream has been closed could throw an ObjectDisposedException.

注意 (継承者)

既定の実装でStream新しい 1 バイトの配列を作成し、呼び出してRead(Byte[], Int32, Int32)します。 The default implementation on Stream creates a new single-byte array and then calls Read(Byte[], Int32, Int32). これは正式には正しいが、効率的です。 While this is formally correct, it is inefficient. 内部バッファーを備えた任意のストリームは、このメソッドをオーバーライドし、バッファーを直接読み込む呼び出しごとに余分な配列の割り当てを回避するはるかに効率的バージョンを提供する必要があります。 Any stream with an internal buffer should override this method and provide a much more efficient version that reads the buffer directly, avoiding the extra array allocation on every call.

適用対象

こちらもご覧ください