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 метода или и ReadLineAsync всю строку с помощью ReadToEnd метода или ReadToEndAsync .

Примечание

Этот тип реализует интерфейс IDisposable, но никакие ресурсы не удаляет. Это означает, что вам не обязательно его удалять, вызывая непосредственно Dispose() или используя такие языковые конструкции, как using (C#) или Using (Visual Basic).

В следующей таблице перечислены примеры других типичных или связанных задач ввода-вывода.

Действие	Раздел с примером
Создание текстового файла.	Практическое руководство. Запись текста в файл
Запись в текстовый файл.	Практическое руководство. Запись текста в файл
Чтение из текстового файла.	Практическое руководство. Чтение текста из файла
Добавление текста в файл.	Практическое руководство. Открытие файла журнала и добавление в него данных 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()	Считывает следующий символ из строки ввода и увеличивает позицию символа на один символ.
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()	Выполняет чтение строки символов из текущей строки и возвращает данные в виде строки.
ReadLineAsync()	Асинхронно выполняет чтение строки символов из текущей строки и возвращает данные в виде строки.
ReadLineAsync(CancellationToken)	Асинхронно выполняет чтение строки символов из текущей строки и возвращает данные в виде строки.
ReadToEnd()	Выполняет чтение всех символов, начиная с текущей позиции до конца строки, и возвращает их в виде одной строки.
ReadToEndAsync()	Асинхронно считывает все символы, начиная с текущей позиции до конца строки, и возвращает их в виде одной строки.
ReadToEndAsync(CancellationToken)	Асинхронно считывает все символы, начиная с текущей позиции до конца строки, и возвращает их в виде одной строки.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

См. также раздел

• TextReader
• StringWriter
• Файловый и потоковый ввод-вывод
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл