StringReader.Read メソッド

定義

入力文字列から次の文字または次の文字セットを読み取ります。Reads the next character or next set of characters from the input string.

オーバーロード

Read()

入力文字列から次の文字を読み取り、1 文字分だけ文字位置を進めます。Reads the next character from the input string and advances the character position by one character.

Read(Span<Char>)

入力文字列の現在位置から開始してすべての文字を読み取り、現在位置を入力文字列の末尾に進めます。Reads all the characters from the input string, starting at the current position, and advances the current position to the end of the input string.

Read(Char[], Int32, Int32)

入力文字列から文字のブロックを読み取り、count だけ文字位置を進めます。Reads a block of characters from the input string and advances the character position by count.

Read()

入力文字列から次の文字を読み取り、1 文字分だけ文字位置を進めます。Reads the next character from the input string and advances the character position by one character.

public:
 override int Read();
public override int Read ();
override this.Read : unit -> int
Public Overrides Function Read () As Integer

戻り値

Int32

基になる文字列の次の文字。または使用できる文字がない場合は -1。The next character from the underlying string, or -1 if no more characters are available.

例外

現在のリーダーが閉じています。The current reader is closed.

このコード例は、StringReader クラスのために提供されている大規模な例の一部です。This code example is part of a larger example provided for the StringReader class.

convertedCharacter = Convert::ToChar( intCharacter );
if ( convertedCharacter == '.' )
{
   strWriter->Write(  ".\n\n" );
   
   // Bypass the spaces between sentences.
   strReader->Read();
   strReader->Read();
}
convertedCharacter = Convert.ToChar(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 メソッドをオーバーライドします。This method overrides the TextReader.Read method.

次の表に、その他の一般的な i/o タスクと関連する i/o タスクの例を示します。The following table lists examples of other typical or related I/O tasks.

目的To do this... 参照項目See the example in this topic...
テキスト ファイルを作成します。Create a text file. 方法: テキストのファイルへの書き込みHow to: Write Text to a File
テキストファイルに書き込みます。Write to a text file. 方法: テキストのファイルへの書き込みHow to: Write Text to a File
テキストファイルからの読み取り。Read from a text file. 方法: ファイルからのテキストの読み取りHow to: Read Text from a File
ファイルにテキストを追加します。Append text to a file. 方法: ログ ファイルを開いて情報を追加するHow to: Open and Append to a Log File

File.AppendText

FileInfo.AppendText
ファイルのサイズを取得します。Get the size of a file. FileInfo.Length
ファイルの属性を取得します。Get the attributes of a file. File.GetAttributes
ファイルの属性を設定します。Set the attributes of a file. File.SetAttributes
ファイルが存在するかどうかを確認します。Determine if a file exists. File.Exists
バイナリファイルから読み取ります。Read from a binary file. 方法: 新しく作成されたデータ ファイルに対して読み書きするHow to: Read and Write to a Newly Created Data File
バイナリファイルに書き込みます。Write to a binary file. 方法: 新しく作成されたデータ ファイルに対して読み書きするHow to: Read and Write to a Newly Created Data File

こちらもご覧ください

適用対象

Read(Span<Char>)

入力文字列の現在位置から開始してすべての文字を読み取り、現在位置を入力文字列の末尾に進めます。Reads all the characters from the input string, starting at the current position, and advances the current position to the end of the input string.

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>

このメソッドから戻ったときは、現在のソースから読み取られた文字が格納されています。When this method returns, contains the characters read from the current source. 読み取られた合計文字数が 0 の場合、スパンは変更されません。If the total number of characters read is zero, the span remains unmodified.

戻り値

Int32

バッファーに読み取られた合計文字数。The total number of characters read into the buffer.

例外

現在の文字列リーダー インスタンスは閉じられます。The current string reader instance is closed.

適用対象

Read(Char[], Int32, Int32)

入力文字列から文字のブロックを読み取り、count だけ文字位置を進めます。Reads a block of characters from the input string and advances the character position by 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) までの値が、現在のソースから読み取られた文字に置き換えられます。When this method returns, contains the specified character array with the values between index and (index + count - 1) replaced by the characters read from the current source.

index
Int32

バッファー内の開始インデックス。The starting index in the buffer.

count
Int32

読み取る文字の数。The number of characters to read.

戻り値

Int32

バッファーに読み取られた合計文字数。The total number of characters read into the buffer. 要求しただけの文字数を読み取ることができなかった場合、この値は要求した文字数より小さくなります。基になる文字列の末尾に到達した場合は 0 になることがあります。This can be less than the number of characters requested if that many characters are not currently available, or zero if the end of the underlying string has been reached.

例外

buffernullです。buffer is null.

バッファーの長さから index を引いた値が count 未満です。The buffer length minus index is less than count.

index または count が負の値です。index or count is negative.

現在のリーダーが閉じています。The current reader is closed.

注釈

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

メソッドは count 、から文字 StringReader buffer 配列の位置で始まる文字までを読み取ります indexThe method will read up to count characters from the StringReader into the buffer character array starting at position index. 実際に読み取られた文字数を返します。文字列の末尾に到達し、文字が読み取られていない場合は0を返します。Returns the actual number of characters read, or zero if the end of the string has been reached and no characters are read.

次の表に、その他の一般的な i/o タスクと関連する i/o タスクの例を示します。The following table lists examples of other typical or related I/O tasks.

目的To do this... 参照項目See the example in this topic...
テキスト ファイルを作成します。Create a text file. 方法: テキストのファイルへの書き込みHow to: Write Text to a File
テキストファイルに書き込みます。Write to a text file. 方法: テキストのファイルへの書き込みHow to: Write Text to a File
テキストファイルからの読み取り。Read from a text file. 方法: ファイルからのテキストの読み取りHow to: Read Text from a File
ファイルにテキストを追加します。Append text to a file. 方法: ログ ファイルを開いて情報を追加するHow to: Open and Append to a Log File

File.AppendText

FileInfo.AppendText
ファイルのサイズを取得します。Get the size of a file. FileInfo.Length
ファイルの属性を取得します。Get the attributes of a file. File.GetAttributes
ファイルの属性を設定します。Set the attributes of a file. File.SetAttributes
ファイルが存在するかどうかを確認します。Determine if a file exists. File.Exists
バイナリファイルから読み取ります。Read from a binary file. 方法: 新しく作成されたデータ ファイルに対して読み書きするHow to: Read and Write to a Newly Created Data File
バイナリファイルに書き込みます。Write to a binary file. 方法: 新しく作成されたデータ ファイルに対して読み書きするHow to: Read and Write to a Newly Created Data File

こちらもご覧ください

適用対象