TextReader.Read メソッド (Char , Int32, Int32)
現在のストリームから最大 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 タスクの例を次の表に示します。
実行するタスク | 参考例があるトピック |
---|---|
テキスト ファイルを作成する。 | ファイルへのテキストの書き込み |
テキスト ファイルに書き込む。 | ファイルへのテキストの書き込み |
テキスト ファイルから読み取る。 | ファイルからのテキストの読み取り |
テキストをファイルに追加する。 | ログ ファイルのオープンと追加 |
ファイルのサイズを取得する。 | 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 クラス | TextReader メンバ | System.IO 名前空間 | TextReader.Read オーバーロードの一覧 | 入出力操作 | ファイルからのテキストの読み取り | ファイルへのテキストの書き込み