다음을 통해 공유


StringReader 클래스

정의

문자열에서 읽어오는 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
상속
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 한 번에 한 줄, 또는 ReadLineAsyncReadToEndAsync 메서드를 사용하여 전체 문자열을 ReadToEnd 읽을 수 있습니다.

참고

이 형식은 IDisposable 인터페이스를 구현하지만 실제로 삭제하는 리소스는 없습니다. 즉 Dispose()를 직접 호출하거나 using(C#) 또는 Using(Visual Basic) 같은 언어 구문을 사용하여 삭제할 필요가 없습니다.

다음 표에는 다른 일반적인 또는 관련 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()

입력 문자열에서 다음 문자를 읽고 문자 위치를 한 문자씩 앞으로 이동합니다.

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()

현재 문자열에서 한 줄의 문자를 읽고 데이터를 문자열로 반환합니다.

ReadLineAsync()

현재 문자열에서 한 줄의 문자를 비동기적으로 읽고 데이터를 문자열로 반환합니다.

ReadLineAsync()

한 줄의 문자를 비동기적으로 읽고 데이터를 문자열로 반환합니다.

(다음에서 상속됨 TextReader)
ReadLineAsync(CancellationToken)

현재 문자열에서 한 줄의 문자를 비동기적으로 읽고 데이터를 문자열로 반환합니다.

ReadLineAsync(CancellationToken)

한 줄의 문자를 비동기적으로 읽고 데이터를 문자열로 반환합니다.

(다음에서 상속됨 TextReader)
ReadToEnd()

현재 위치부터 문자열 끝까지의 모든 문자를 읽어서 이를 단일 문자열로 반환합니다.

ReadToEndAsync()

현재 위치부터 문자열 끝까지의 모든 문자를 비동기적으로 읽어서 이를 단일 문자열로 반환합니다.

ReadToEndAsync()

현재 위치에서 텍스트 판독기 끝까지의 모든 문자를 비동기적으로 읽어서 하나의 문자열로 반환합니다.

(다음에서 상속됨 TextReader)
ReadToEndAsync(CancellationToken)

현재 위치부터 문자열 끝까지의 모든 문자를 비동기적으로 읽어서 이를 단일 문자열로 반환합니다.

ReadToEndAsync(CancellationToken)

현재 위치에서 텍스트 판독기 끝까지의 모든 문자를 비동기적으로 읽어서 하나의 문자열로 반환합니다.

(다음에서 상속됨 TextReader)
ToString()

현재 개체를 나타내는 문자열을 반환합니다.

(다음에서 상속됨 Object)

명시적 인터페이스 구현

IDisposable.Dispose()

이 멤버에 대한 설명은 Dispose()를 참조하세요.

(다음에서 상속됨 TextReader)

적용 대상

추가 정보