TextReader.Read メソッド (Char , Int32, Int32)

[アーティクル]
03/28/2008

現在のストリームから最大 count 文字を読み取り、読み取った文字を index を開始位置として buffer に書き込みます。

Overloads Public Overridable Function Read( _
   <InteropServices.In(), _
   Out()> ByVal buffer() As Char, _   ByVal index As Integer, _   ByVal count As Integer _) As Integer
[C#]
public virtual int Read(   [   In,   Out] char[] buffer,intindex,intcount);
[C++]
public: virtual int Read(   [   In,   Out] __wchar_tbuffer __gc[],intindex,intcount);
[JScript]
public function Read(
   buffer : Char[],index : int,count : int) : int;

パラメータ

buffer
このメソッドが戻るとき、指定した文字配列の index から (index + count- 1) までの値が、現在のソースから読み取られた文字に置き換えられます。
index
書き込みを開始する buffer 内の位置。
count
読み取り対象の最大文字数。 count で指定された文字数を buffer に読み取る前にストリームの末尾に到達した場合、現在のメソッドは制御を返します。

戻り値

読み取られた文字数。この数値は、ストリーム内に使用できるデータがあるかどうかによって異なりますが、 count 以下の数値になります。読み取り対象の文字がない場合にこのメソッドを呼び出すと、0 が返されます。

例外

例外の種類	条件
ArgumentNullException	buffer が null 参照 (Visual Basic では Nothing) です。
ArgumentException	バッファ長から index を差し引いた値が count より小さい値です。
ArgumentOutOfRangeException	index または count が負の値です。
ObjectDisposedException	TextReader が閉じています。
IOException	I/O エラーが発生しました。

解説

このメソッドは、 count の文字が読み取られた後か、ファイルの末尾に達した後に戻り値を返します。 ReadBlock は、このメソッドのブロッキングバージョンです。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルを作成する。	ファイルへのテキストの書き込み
テキストファイルに書き込む。	ファイルへのテキストの書き込み
テキストファイルから読み取る。	ファイルからのテキストの読み取り
テキストをファイルに追加する。	ログファイルのオープンと追加 File.AppendText FileInfo.AppendText
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリファイルから読み取る。	新しく作成したデータファイルの読み取りと書き込み
バイナリファイルに書き込む。	新しく作成したデータファイルの読み取りと書き込み

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard

参照

次の方法で共有

TextReader.Read メソッド (Char , Int32, Int32)

パラメータ

戻り値

例外

解説

必要条件

参照

その他のリソース