StringReader 클래스

정의

문자열에서 읽어오는 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 메서드를 사용 하 여 시간을 줄을 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 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the StringReader class that reads from the specified string.

메서드

Close()

StringReader를 닫습니다.Closes the StringReader.

CreateObjRef(Type)

원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(다음에서 상속됨 MarshalByRefObject)
Dispose()

해당 TextReader 개체에서 사용하는 리소스를 모두 해제합니다.Releases all resources used by the TextReader object.

(다음에서 상속됨 TextReader)
Dispose(Boolean)

StringReader에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다.Releases the unmanaged resources used by the StringReader and optionally releases the managed resources.

Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetLifetimeService()

이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(다음에서 상속됨 MarshalByRefObject)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
InitializeLifetimeService()

이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다.Obtains a lifetime service object to control the lifetime policy for this instance.

(다음에서 상속됨 MarshalByRefObject)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
MemberwiseClone(Boolean)

현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다.Creates a shallow copy of the current MarshalByRefObject object.

(다음에서 상속됨 MarshalByRefObject)
Peek()

사용할 수 있는 다음 문자를 반환하지만 사용하지는 않습니다.Returns the next available character but does not consume it.

Read()

입력 문자열에서 다음 문자를 읽고 문자 위치를 한 문자씩 앞으로 이동합니다.Reads the next character from the input string and advances the character position by one character.

Read(Char[], Int32, Int32)

입력 문자열에서 문자 블록을 읽은 다음 문자 위치를 count씩 앞으로 이동합니다.Reads a block of characters from the input string and advances the character position by count.

Read(Span<Char>)
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)
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.

(다음에서 상속됨 TextReader)
ReadBlock(Span<Char>)
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)
ReadLine()

현재 문자열에서 한 줄의 문자를 읽고 데이터를 문자열로 반환합니다.Reads a line of characters from the current string and returns the data as a string.

ReadLineAsync()

현재 문자열에서 한 줄의 문자를 비동기적으로 읽고 데이터를 문자열로 반환합니다.Reads a line of characters asynchronously from the current string and returns the data as a string.

ReadToEnd()

현재 위치부터 문자열 끝까지의 모든 문자를 읽어서 이를 단일 문자열로 반환합니다.Reads all characters from the current position to the end of the string and returns them as a single string.

ReadToEndAsync()

현재 위치부터 문자열 끝까지의 모든 문자를 비동기적으로 읽어서 이를 단일 문자열로 반환합니다.Reads all characters from the current position to the end of the string asynchronously and returns them as a single string.

ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)

명시적 인터페이스 구현

IDisposable.Dispose()

이 멤버에 대한 설명은 Dispose()를 참조하십시오.For a description of this member, see Dispose().

(다음에서 상속됨 TextReader)

적용 대상

추가 정보