TextReader.ReadBlock メソッド

.NET Framework クラス ライブラリ リファレンス

TextReader.ReadBlock メソッド

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

名前空間: System.IO
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 ReadBlock ( _
    <InAttribute> <OutAttribute> buffer As Char(),
 _
    index As Integer, _
    count As Integer _
) As Integer

Visual Basic (使用法)

Dim instance As TextReader
Dim buffer As Char()
Dim index As Integer
Dim count As Integer
Dim returnValue As Integer

returnValue = instance.ReadBlock(buffer, index, count)

C#

public virtual int ReadBlock (
    [InAttribute] [OutAttribute] char[] buffer,
    int index,
    int count
)

C++

public:
virtual int ReadBlock (
    [InAttribute] [OutAttribute] array<wchar_t>^ buffer, 
    int index, 
    int count
)

J#

public int ReadBlock (
    /** @attribute InAttribute() */ /** @attribute OutAttribute() */ char[]
 buffer, 
    int index, 
    int count
)

JScript

public function ReadBlock (
    buffer : char[], 
    index : int, 
    count : int
) : int

パラメータ

buffer

このメソッドが戻るとき、指定した文字配列の index から (index + count -1) までの値が、現在のソースから読み取られた文字に置き換えられています。

index

書き込みを開始する buffer 内の位置。

count

読み取り対象の最大文字数。

戻り値
読み取られた文字数。この数値は、すべての入力文字が読み取られたかどうかによって異なりますが、count 以下の数値になります。

例外

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

解説

このメソッドは、指定した count 文字か、すべての文字が読み取られるまでブロッキングを行います。このメソッドは、Read のブロッキング バージョンです。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
TextReader クラス
TextReader メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む