StringReader.Read メソッド

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

入力文字列から次の文字または次の文字セットを読み取ります。

オーバーロード

Read()	入力文字列から次の文字を読み取り、1 文字分だけ文字位置を進めます。
Read(Span<Char>)	入力文字列の現在位置から開始してすべての文字を読み取り、現在位置を入力文字列の末尾に進めます。
Read(Char[], Int32, Int32)	入力文字列から文字のブロックを読み取り、count だけ文字位置を進めます。

Read()

ソース:

StringReader.cs

入力文字列から次の文字を読み取り、1 文字分だけ文字位置を進めます。

public:
 override int Read();

public override int Read ();

override this.Read : unit -> int

Public Overrides Function Read () As Integer

戻り値

Int32

基になる文字列の次の文字。または使用できる文字がない場合は -1。

例外

ObjectDisposedException

現在のリーダーが閉じています。

例

このコード例は、StringReader クラスのために提供されている大規模な例の一部です。

convertedCharacter = Convert::ToChar( intCharacter );
if ( convertedCharacter == '.' )
{
   strWriter->Write(  ".\n\n" );
   
   // Bypass the spaces between sentences.
   strReader->Read();
   strReader->Read();
}

convertedCharacter = (char)intCharacter;
if(convertedCharacter == '.')
{
    strWriter.Write(".\n\n");

    // Bypass the spaces between sentences.
    strReader.Read();
    strReader.Read();
}

convertedCharacter = Convert.ToChar(intCharacter)
If convertedCharacter = "."C Then
    strWriter.Write("." & vbCrLf & vbCrLf)

    ' Bypass the spaces between sentences.
    strReader.Read()
    strReader.Read()

注釈

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

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

目的	参照項目
テキスト ファイルを作成します。	方法: テキストのファイルへの書き込み
テキスト ファイルに書き込みます。	方法: テキストのファイルへの書き込み
テキスト ファイルから読み取ります。	方法: ファイルからのテキストの読み取り
ファイルにテキストを追加します。	方法: ログ ファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルのサイズを取得します。	FileInfo.Length
ファイルの属性を取得します。	File.GetAttributes
ファイルの属性を設定します。	File.SetAttributes
ファイルが存在するかどうかを確認します。	File.Exists
バイナリ ファイルから読み取ります。	方法: 新しく作成されたデータ ファイルに対して読み書きする
バイナリ ファイルに書き込みます。	方法: 新しく作成されたデータ ファイルに対して読み書きする

こちらもご覧ください

• ファイルおよびストリーム入出力
• 方法: ファイルからのテキストの読み取り
• 方法: テキストのファイルへの書き込み

Read(Span<Char>)

ソース:

StringReader.cs

入力文字列の現在位置から開始してすべての文字を読み取り、現在位置を入力文字列の末尾に進めます。

public:
 override int Read(Span<char> buffer);

public override int Read (Span<char> buffer);

override this.Read : Span<char> -> int

Public Overrides Function Read (buffer As Span(Of Char)) As Integer

パラメーター

buffer

Span<Char>

このメソッドから戻ったときは、現在のソースから読み取られた文字が格納されています。 読み取られた合計文字数が 0 の場合、スパンは変更されません。

戻り値

Int32

バッファーに読み取られた合計文字数。

例外

ObjectDisposedException

現在の文字列リーダー インスタンスは閉じられます。

Read(Char[], Int32, Int32)

ソース:

StringReader.cs

入力文字列から文字のブロックを読み取り、count だけ文字位置を進めます。

public:
 override int Read(cli::array <char> ^ buffer, int index, int count);

public override int Read (char[] buffer, int index, int count);

override this.Read : char[] * int * int -> int

Public Overrides Function Read (buffer As Char(), index As Integer, count As Integer) As Integer

パラメーター

buffer

Char[]

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

index

Int32

バッファー内の開始インデックス。

count

Int32

読み取る文字の数。

戻り値

Int32

バッファーに読み取られた合計文字数。 要求しただけの文字数を読み取ることができなかった場合、この値は要求した文字数より小さくなります。基になる文字列の末尾に到達した場合は 0 になることがあります。

例外

ArgumentNullException

buffer が nullです。

ArgumentException

バッファーの長さから index を引いた値が count 未満です。

ArgumentOutOfRangeException

index または count が負の値です。

ObjectDisposedException

現在のリーダーが閉じています。

注釈

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

メソッドは、 から StringReader 位置 indexから始まる文字配列に最大countで文字を読み取bufferります。 読み取られた実際の文字数を返します。文字列の末尾に達し、読み取られた文字がない場合は 0 を返します。

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

目的	参照項目
テキスト ファイルを作成します。	方法: テキストのファイルへの書き込み
テキスト ファイルに書き込みます。	方法: テキストのファイルへの書き込み
テキスト ファイルから読み取ります。	方法: ファイルからのテキストの読み取り
ファイルにテキストを追加します。	方法: ログ ファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルのサイズを取得します。	FileInfo.Length
ファイルの属性を取得します。	File.GetAttributes
ファイルの属性を設定します。	File.SetAttributes
ファイルが存在するかどうかを確認します。	File.Exists
バイナリ ファイルから読み取ります。	方法: 新しく作成されたデータ ファイルに対して読み書きする
バイナリ ファイルに書き込みます。	方法: 新しく作成されたデータ ファイルに対して読み書きする

こちらもご覧ください

• ファイルおよびストリーム入出力
• 方法: ファイルからのテキストの読み取り
• 方法: テキストのファイルへの書き込み