StringReader クラス

定義

名前空間:

System.IO

アセンブリ:

System.IO.dll

アセンブリ:

System.Runtime.dll

アセンブリ:

System.Runtime.Extensions.dll

アセンブリ:

mscorlib.dll

アセンブリ:

netstandard.dll

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

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

public class StringReader : System.IO.TextReader

[System.Serializable]
public class StringReader : System.IO.TextReader

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class StringReader : System.IO.TextReader

type StringReader = class
    inherit TextReader

[<System.Serializable>]
type StringReader = class
    inherit TextReader

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StringReader = class
    inherit TextReader

Public Class StringReader
Inherits TextReader

継承

Object

TextReader

StringReader

継承

Object

MarshalByRefObject

TextReader

StringReader

属性

SerializableAttribute ComVisibleAttribute

例

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

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 では、文字列を同期的または非同期的に読み取ります。 メソッドまたはメソッドを使用して一度にReadReadAsync文字を読み取り、またはメソッドを使用して一度にReadLineAsyncReadLine行を読み取り、またはメソッドを使用して文字列全体をReadToEndReadToEndAsync読み取ることができます。

注意

この型は 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 を閉じます。
Close()	TextReader を閉じ、その TextReader と関連付けられているシステム リソースを解放します。 (継承元 TextReader)
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>)	入力文字列の現在位置から開始してすべての文字を読み取り、現在位置を入力文字列の末尾に進めます。
Read(Span<Char>)	現在のリーダーから文字を読み取り、指定したバッファーにそのデータを書き込みます。 (継承元 TextReader)
ReadAsync(Char[], Int32, Int32)	指定した最大文字数を現在の文字列から非同期的に読み取り、バッファーの指定したインデックス位置にそのデータを書き込みます。
ReadAsync(Char[], Int32, Int32)	指定した最大文字数を現在のテキスト リーダーから非同期に読み取り、バッファーの指定したインデックス位置にそのデータを書き込みます。 (継承元 TextReader)
ReadAsync(Memory<Char>, CancellationToken)	非同期的に、入力文字列の現在位置から開始してすべての文字を読み取り、現在位置を入力文字列の末尾に進めます。
ReadAsync(Memory<Char>, CancellationToken)	現在のストリームからメモリ ブロックに文字を非同期に読み取ります。 (継承元 TextReader)
ReadBlock(Char[], Int32, Int32)	指定した最大文字数を現在のテキスト リーダーから読み取り、バッファーの指定したインデックス位置にそのデータを書き込みます。 (継承元 TextReader)
ReadBlock(Span<Char>)	入力文字列の現在位置から開始してすべての文字を読み取り、現在位置を入力文字列の末尾に進めます。
ReadBlock(Span<Char>)	現在のストリームから文字を読み取り、データをバッファーに書き込みます。 (継承元 TextReader)
ReadBlockAsync(Char[], Int32, Int32)	指定した最大文字数を現在の文字列から非同期的に読み取り、バッファーの指定したインデックス位置にそのデータを書き込みます。
ReadBlockAsync(Char[], Int32, Int32)	指定した最大文字数を現在のテキスト リーダーから非同期に読み取り、バッファーの指定したインデックス位置にそのデータを書き込みます。 (継承元 TextReader)
ReadBlockAsync(Memory<Char>, CancellationToken)	非同期的に、入力文字列の現在位置から開始してすべての文字を読み取り、現在位置を入力文字列の末尾に進めます。
ReadBlockAsync(Memory<Char>, CancellationToken)	現在のストリームから非同期に文字を読み取り、データをバッファーに書き込みます。 (継承元 TextReader)
ReadLine()	現在の文字列から 1 行分の文字を読み取り、そのデータを文字列として返します。
ReadLineAsync()	現在の文字列から非同期的に 1 行分の文字を読み取り、そのデータを文字列として返します。
ReadLineAsync()	1 行分の文字を非同期的に読み取り、そのデータを文字列として返します。 (継承元 TextReader)
ReadLineAsync(CancellationToken)	現在の文字列から非同期的に 1 行分の文字を読み取り、そのデータを文字列として返します。
ReadLineAsync(CancellationToken)	1 行分の文字を非同期的に読み取り、そのデータを文字列として返します。 (継承元 TextReader)
ReadToEnd()	現在位置から文字列の末尾まですべての文字を読み取り、1 つの文字列として返します。
ReadToEndAsync()	現在位置から文字列の末尾まですべての文字を非同期的に読み取り、1 つの文字列として返します。
ReadToEndAsync()	テキスト リーダーの現在位置から末尾まですべての文字を非同期的に読み取り、1 つの文字列として返します。 (継承元 TextReader)
ReadToEndAsync(CancellationToken)	現在位置から文字列の末尾まですべての文字を非同期的に読み取り、1 つの文字列として返します。
ReadToEndAsync(CancellationToken)	テキスト リーダーの現在位置から末尾まですべての文字を非同期的に読み取り、1 つの文字列として返します。 (継承元 TextReader)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

明示的なインターフェイスの実装

IDisposable.Dispose()

このメンバーの詳細については、「Dispose()」をご覧ください。 (継承元 TextReader)

こちらもご覧ください

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