StringReader クラス

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

ソース:

StringReader.cs

文字列から読み取る TextReader を実装します。

public ref class StringReader : System::IO::TextReader

public class StringReader : System.IO.TextReader

type StringReader = class
    inherit TextReader

Public Class StringReader
Inherits TextReader

継承

Object

MarshalByRefObject

TextReader

StringReader

例

次の例は、文字列全体を非同期的に読み取る方法を示しています。

using System;
using System.IO;
using System.Text;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            ReadCharacters();
        }

        static async void ReadCharacters()
        {
            StringBuilder stringToRead = new StringBuilder();
            stringToRead.AppendLine("Characters in 1st line to read");
            stringToRead.AppendLine("and 2nd line");
            stringToRead.AppendLine("and the end");

            using (StringReader reader = new StringReader(stringToRead.ToString()))
            {
                string readText = await reader.ReadToEndAsync();
                Console.WriteLine(readText);
            }
        }
    }
}
// The example displays the following output:
//
// Characters in 1st line to read
// and 2nd line
// and the end
//

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        ReadCharacters()
    End Sub

    Async Sub ReadCharacters()
        Dim stringToRead = New StringBuilder()
        stringToRead.AppendLine("Characters in 1st line to read")
        stringToRead.AppendLine("and 2nd line")
        stringToRead.AppendLine("and the end")

        Using reader As StringReader = New StringReader(stringToRead.ToString())
            Dim readText As String = Await reader.ReadToEndAsync()
            Console.WriteLine(readText)
        End Using
    End Sub
End Module
' The example displays the following output:
'
' Characters in 1st line to read
' and 2nd line
' and the end
'

注釈

StringReader を使用すると、文字列を同期的または非同期的に読み取ります。 または メソッドを使用 Read して一度に文字を ReadAsync 読み取り、 メソッドまたは メソッドを使用して ReadLine 一度に 1 行ずつ読み取り、 メソッドまたは ReadLineAsync メソッドを使用して ReadToEnd 文字列全体を ReadToEndAsync 読み取ることができます。

注意

この型は IDisposable インターフェイスを実装しますが、実際に破棄するリソースはありません。 つまり、Dispose() を直接呼び出したり、using (C# の場合) または Using (Visual Basic の場合) といった言語構築を行ってリソースを破棄する必要はありません。

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

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

コンストラクター

StringReader(String)

指定した文字列から読み取る StringReader クラスの新しいインスタンスを初期化します。

メソッド

Close()	StringReader を閉じます。
CreateObjRef(Type)	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (継承元 MarshalByRefObject)
Dispose()	この TextReader オブジェクトによって使用されているすべてのリソースを解放します。 (継承元 TextReader)
Dispose(Boolean)	StringReader によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetLifetimeService()	古い. 対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
InitializeLifetimeService()	古い. このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
MemberwiseClone(Boolean)	現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject)
Peek()	使用可能な次の文字を返しますが、その文字は使用されません。
Read()	入力文字列から次の文字を読み取り、1 文字分だけ文字位置を進めます。
Read(Char[], Int32, Int32)	入力文字列から文字のブロックを読み取り、count だけ文字位置を進めます。
Read(Span<Char>)	入力文字列の現在位置から開始してすべての文字を読み取り、現在位置を入力文字列の末尾に進めます。
ReadAsync(Char[], Int32, Int32)	指定した最大文字数を現在の文字列から非同期的に読み取り、バッファーの指定したインデックス位置にそのデータを書き込みます。
ReadAsync(Memory<Char>, CancellationToken)	非同期的に、入力文字列の現在位置から開始してすべての文字を読み取り、現在位置を入力文字列の末尾に進めます。
ReadBlock(Char[], Int32, Int32)	指定した最大文字数を現在のテキスト リーダーから読み取り、バッファーの指定したインデックス位置にそのデータを書き込みます。 (継承元 TextReader)
ReadBlock(Span<Char>)	入力文字列の現在位置から開始してすべての文字を読み取り、現在位置を入力文字列の末尾に進めます。
ReadBlockAsync(Char[], Int32, Int32)	指定した最大文字数を現在の文字列から非同期的に読み取り、バッファーの指定したインデックス位置にそのデータを書き込みます。
ReadBlockAsync(Memory<Char>, CancellationToken)	非同期的に、入力文字列の現在位置から開始してすべての文字を読み取り、現在位置を入力文字列の末尾に進めます。
ReadLine()	現在の文字列から 1 行分の文字を読み取り、そのデータを文字列として返します。
ReadLineAsync()	現在の文字列から非同期的に 1 行分の文字を読み取り、そのデータを文字列として返します。
ReadLineAsync(CancellationToken)	現在の文字列から非同期的に 1 行分の文字を読み取り、そのデータを文字列として返します。
ReadToEnd()	現在位置から文字列の末尾まですべての文字を読み取り、1 つの文字列として返します。
ReadToEndAsync()	現在位置から文字列の末尾まですべての文字を非同期的に読み取り、1 つの文字列として返します。
ReadToEndAsync(CancellationToken)	現在位置から文字列の末尾まですべての文字を非同期的に読み取り、1 つの文字列として返します。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

こちらもご覧ください

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