StringReader Klasa

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Źródło:

StringReader.cs

Implementuje element TextReader odczytywany z ciągu.

public ref class StringReader : System::IO::TextReader

public class StringReader : System.IO.TextReader

type StringReader = class
    inherit TextReader

Public Class StringReader
Inherits TextReader

Dziedziczenie

Object

MarshalByRefObject

TextReader

StringReader

Przykłady

W poniższym przykładzie pokazano, jak odczytywać cały ciąg asynchronicznie.

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
'

Uwagi

StringReader umożliwia odczytywanie ciągu synchronicznie lub asynchronicznie. Znak można odczytać w czasie za Read pomocą metody lub ReadAsync , wiersza w czasie przy użyciu metody lub i ReadLineAsync całego ciągu przy użyciu ReadLineReadToEnd metody lub lub ReadToEndAsync metody .

Uwaga

Ten typ implementuje IDisposable interfejs, ale w rzeczywistości nie ma żadnych zasobów do usunięcia. Oznacza to, że dysponowanie go przez bezpośrednie wywołanie Dispose() lub użycie konstrukcji językowej, takiej jak using (w języku C#) lub Using (w Visual Basic) nie jest konieczne.

W poniższej tabeli wymieniono przykłady innych typowych lub powiązanych zadań we/wy.

Aby wykonać tę czynność...	Zobacz przykład w tym temacie...
Twórca pliku tekstowego.	Instrukcje: Zapisywanie tekstu w pliku
Zapisywanie w pliku tekstowym.	Instrukcje: Zapisywanie tekstu w pliku
Odczyt z pliku tekstowego.	Instrukcje: Odczytywanie tekstu z pliku
Dołącz tekst do pliku.	Instrukcje: Otwieranie pliku dziennika i dołączanie do niego File.AppendText FileInfo.AppendText
Pobierz rozmiar pliku.	FileInfo.Length
Pobierz atrybuty pliku.	File.GetAttributes
Ustaw atrybuty pliku.	File.SetAttributes
Ustal, czy plik istnieje.	File.Exists
Odczyt z pliku binarnego.	Instrukcje: Odczyt i zapis we właśnie utworzonym pliku danych
Zapisywanie w pliku binarnym.	Instrukcje: Odczyt i zapis we właśnie utworzonym pliku danych

Konstruktory

StringReader(String)

Inicjuje StringReader nowe wystąpienie klasy, która odczytuje z określonego ciągu.

Metody

Close()	Zamyka element StringReader.
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszystkie zasoby używane przez TextReader obiekt. (Odziedziczone po TextReader)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element StringReader i opcjonalnie zwalnia zasoby zarządzane.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Przestarzałe. Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
InitializeLifetimeService()	Przestarzałe. Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
Peek()	Zwraca następny dostępny znak, ale nie używa go.
Read()	Odczytuje następny znak z ciągu wejściowego i rozwija pozycję znaku o jeden znak.
Read(Char[], Int32, Int32)	Odczytuje blok znaków z ciągu wejściowego i rozwija pozycję znaku przez .count
Read(Span<Char>)	Odczytuje wszystkie znaki z ciągu wejściowego, zaczynając od bieżącej pozycji, i przechodzi do bieżącej pozycji na końcu ciągu wejściowego.
ReadAsync(Char[], Int32, Int32)	Odczytuje określoną maksymalną liczbę znaków z bieżącego ciągu asynchronicznie i zapisuje dane w buforze, zaczynając od określonego indeksu.
ReadAsync(Memory<Char>, CancellationToken)	Asynchronicznie odczytuje wszystkie znaki z ciągu wejściowego, zaczynając od bieżącej pozycji, i przesuwa bieżącą pozycję na końcu ciągu wejściowego.
ReadBlock(Char[], Int32, Int32)	Odczytuje określoną maksymalną liczbę znaków z bieżącego czytnika tekstu i zapisuje dane w buforze, zaczynając od określonego indeksu. (Odziedziczone po TextReader)
ReadBlock(Span<Char>)	Odczytuje wszystkie znaki z ciągu wejściowego rozpoczynającego się od bieżącej pozycji i przechodzi do bieżącej pozycji na końcu ciągu wejściowego.
ReadBlockAsync(Char[], Int32, Int32)	Odczytuje określoną maksymalną liczbę znaków z bieżącego ciągu asynchronicznie i zapisuje dane w buforze, zaczynając od określonego indeksu.
ReadBlockAsync(Memory<Char>, CancellationToken)	Asynchronicznie odczytuje wszystkie znaki z ciągu wejściowego rozpoczynającego się od bieżącej pozycji i przesuwa bieżącą pozycję na końcu ciągu wejściowego.
ReadLine()	Odczytuje wiersz znaków z bieżącego ciągu i zwraca dane jako ciąg.
ReadLineAsync()	Odczytuje wiersz znaków asynchronicznie z bieżącego ciągu i zwraca dane jako ciąg.
ReadLineAsync(CancellationToken)	Odczytuje wiersz znaków asynchronicznie z bieżącego ciągu i zwraca dane jako ciąg.
ReadToEnd()	Odczytuje wszystkie znaki z bieżącej pozycji na końcu ciągu i zwraca je jako pojedynczy ciąg.
ReadToEndAsync()	Odczytuje wszystkie znaki z bieżącej pozycji na końcu ciągu asynchronicznie i zwraca je jako pojedynczy ciąg.
ReadToEndAsync(CancellationToken)	Odczytuje wszystkie znaki z bieżącej pozycji na końcu ciągu asynchronicznie i zwraca je jako pojedynczy ciąg.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• TextReader
• StringWriter
• Plik i Stream we/wy
• Instrukcje: Odczytywanie tekstu z pliku
• Instrukcje: Zapisywanie tekstu w pliku