StringReader Класс

Ссылка

Определение

Пространство имен:: System.IO

Сборка:: System.IO.dll

Сборка:: System.Runtime.dll

Сборка:: System.Runtime.Extensions.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Исходный код:: StringReader.cs

Исходный код:: StringReader.cs

Исходный код:: StringReader.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Реализует класс 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)

Применяется к

Поделиться через