StreamReader.DiscardBufferedData メソッド

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

StreamReader.DiscardBufferedData メソッド

StreamReader オブジェクトが、現在のデータを破棄できるようにします。

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

Visual Basic (宣言)

Public Sub DiscardBufferedData

Visual Basic (使用法)

Dim instance As StreamReader

instance.DiscardBufferedData

C#

public void DiscardBufferedData ()

C++

public:
void DiscardBufferedData ()

J#

public void DiscardBufferedData ()

JScript

public function DiscardBufferedData ()

解説

DiscardBufferedData は、基になるストリーム内の既知の場所へのシークを行った後にその新しいポイントから読み込みを開始するか、StreamReader オブジェクトの内容を複数回読み込むために使用します。このメソッドはパフォーマンスの低下を招く可能性があるため、頻繁に使用するのは控え、必要な場合だけ使用するようにしてください。

読み取り用のメソッドでは、基になるストリームの現在位置が更新されないため、クラスによっては、そのインスタンスはストリームに実際に存在する文字よりも多くの文字を返す場合があります。この問題を回避する手段の 1 つが、DiscardBufferedData を使用して、StreamReader オブジェクトの内部バッファの内容を破棄する方法です。

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

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

プラットフォーム

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

参照

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