StringReader StringReader StringReader StringReader Class

定義

実装をTextReader文字列から読み取る。Implements a TextReader that reads from a string.

public ref class StringReader : System::IO::TextReader
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class StringReader : System.IO.TextReader
type StringReader = class
    inherit TextReader
Public Class StringReader
Inherits TextReader
継承
属性

次の例では、非同期的に文字列全体を読み取る方法を示します。The following example shows how to read an entire string asynchronously.

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 同期または非同期で文字列を読み取ることができます。StringReader enables you to read a string synchronously or asynchronously. 回に文字を読み取ることができます、ReadまたはReadAsyncメソッドは、時間を使用して、一度に 1 行、ReadLineまたはReadLineAsyncメソッドと、文字列全体を使用して、ReadToEndまたはReadToEndAsyncメソッド。You can read a character at a time with the Read or the ReadAsync method, a line at a time using the ReadLine or the ReadLineAsync method and an entire string using the ReadToEnd or the ReadToEndAsync method.

注意

この型は IDisposable インターフェイスを実装しますが、実際に破棄するリソースはありません。This type implements the IDisposable interface, but does not actually have any resources to dispose. つまり、Dispose() を直接呼び出したり、using (C# の場合) または Using (Visual Basic の場合) といった言語構築を行ってリソースを破棄する必要はありません。This means that disposing it by directly calling Dispose() or by using a language construct such as using (in C#) or Using (in Visual Basic) is not necessary.

次の表では、その他の一般的なまたは関連する 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

コンストラクター

StringReader(String) StringReader(String) StringReader(String) StringReader(String)

新しいインスタンスを初期化、StringReaderクラスを指定した文字列から読み取る。Initializes a new instance of the StringReader class that reads from the specified string.

メソッド

Close() Close() Close() Close()

StringReader を閉じます。Closes the StringReader.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

この TextReader オブジェクトによって使用されているすべてのリソースを解放します。Releases all resources used by the TextReader object.

(Inherited from TextReader)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

StringReader によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。Releases the unmanaged resources used by the StringReader and optionally releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Peek() Peek() Peek() Peek()

使用可能な次の文字を返しますが、その文字は使用されません。Returns the next available character but does not consume it.

Read() Read() Read() Read()

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

Read(Char[], Int32, Int32) Read(Char[], Int32, Int32) Read(Char[], Int32, Int32) Read(Char[], Int32, Int32)

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

Read(Span<Char>) Read(Span<Char>) Read(Span<Char>) Read(Span<Char>)
ReadAsync(Char[], Int32, Int32) ReadAsync(Char[], Int32, Int32) ReadAsync(Char[], Int32, Int32) ReadAsync(Char[], Int32, Int32)

現在の文字列から指定の最大数の文字を非同期的に読み取りし、データを指定したインデックスから始まるバッファーに書き込みます。Reads a specified maximum number of characters from the current string asynchronously and writes the data to a buffer, beginning at the specified index.

ReadAsync(Memory<Char>, CancellationToken) ReadAsync(Memory<Char>, CancellationToken) ReadAsync(Memory<Char>, CancellationToken) ReadAsync(Memory<Char>, CancellationToken)
ReadBlock(Char[], Int32, Int32) ReadBlock(Char[], Int32, Int32) ReadBlock(Char[], Int32, Int32) ReadBlock(Char[], Int32, Int32)

指定した最大文字数を現在のテキスト リーダーから読み取り、バッファーの指定したインデックス位置にそのデータを書き込みます。Reads a specified maximum number of characters from the current text reader and writes the data to a buffer, beginning at the specified index.

(Inherited from TextReader)
ReadBlock(Span<Char>) ReadBlock(Span<Char>) ReadBlock(Span<Char>) ReadBlock(Span<Char>)
ReadBlockAsync(Char[], Int32, Int32) ReadBlockAsync(Char[], Int32, Int32) ReadBlockAsync(Char[], Int32, Int32) ReadBlockAsync(Char[], Int32, Int32)

現在の文字列から指定の最大数の文字を非同期的に読み取りし、データを指定したインデックスから始まるバッファーに書き込みます。Reads a specified maximum number of characters from the current string asynchronously and writes the data to a buffer, beginning at the specified index.

ReadBlockAsync(Memory<Char>, CancellationToken) ReadBlockAsync(Memory<Char>, CancellationToken) ReadBlockAsync(Memory<Char>, CancellationToken) ReadBlockAsync(Memory<Char>, CancellationToken)
ReadLine() ReadLine() ReadLine() ReadLine()

現在の文字列から文字の行を読み取り、文字列としてデータを返します。Reads a line of characters from the current string and returns the data as a string.

ReadLineAsync() ReadLineAsync() ReadLineAsync() ReadLineAsync()

現在の文字列から文字の行を非同期的に読み取りし、データを文字列として返します。Reads a line of characters asynchronously from the current string and returns the data as a string.

ReadToEnd() ReadToEnd() ReadToEnd() ReadToEnd()

文字列の末尾に、現在の位置からのすべての文字を読み取り、1 つの文字列として返します。Reads all characters from the current position to the end of the string and returns them as a single string.

ReadToEndAsync() ReadToEndAsync() ReadToEndAsync() ReadToEndAsync()

文字列の末尾に、現在の位置からのすべての文字を非同期的に読み取りし、1 つの文字列として返します。Reads all characters from the current position to the end of the string asynchronously and returns them as a single string.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

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

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

このメンバーの説明については、Dispose() のトピックを参照してください。For a description of this member, see Dispose().

(Inherited from TextReader)

適用対象

こちらもご覧ください