StringReader.Peek メソッド

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

StringReader.Peek メソッド

読み取り可能な次の文字を返しますが、その文字は使用されません。

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

Visual Basic (宣言)

Public Overrides Function
 Peek As Integer

Visual Basic (使用法)

Dim instance As StringReader
Dim returnValue As Integer

returnValue = instance.Peek

C#

public override int Peek ()

C++

public:
virtual int Peek () override

J#

public int Peek ()

JScript

public override function Peek () : int

戻り値
読み取り対象の次の文字を表す整数。使用できる文字がないか、ストリームがシークをサポートしていない場合は -1。

例外

例外の種類	条件
ObjectDisposedException	現在のリーダーが閉じています。

解説

Peek メソッドは、ファイルの末尾に達したのか、または別のエラーが発生したのかを判断するために、整数値を返します。これにより、ユーザーは戻り値が -1 かどうかをチェックしてから Char 型にキャストできます。

このメソッドは、TextReader.Peek メソッドをオーバーライドします。

StringReader の現在位置が、この操作によって変更されることはありません。

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

実行するタスク	参考例があるトピック
テキスト ファイルを作成する。	方法 : ファイルにテキストを書き込む
テキスト ファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキスト ファイルから読み取る。	方法 : ファイルからテキストを読み取る
ファイルのサイズを取得する。	FileInfo.Length

プラットフォーム

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

参照

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