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 позволяет считывать строку синхронно или асинхронно. Символ можно считывать одновременно с 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.
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)

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

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