StringReader Klasa

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.IO.dll

Zestaw:

System.Runtime.dll

Zestaw:

System.Runtime.Extensions.dll

Zestaw:

mscorlib.dll

Zestaw:

netstandard.dll

Implementuje element TextReader odczytujący z ciągu.

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

Dziedziczenie

Object

TextReader

StringReader

Dziedziczenie

Object

MarshalByRefObject

TextReader

StringReader

Atrybuty

SerializableAttribute ComVisibleAttribute

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 synchronicznie lub asynchronicznie odczytywanie ciągu. Znak można odczytać jednocześnie za Read pomocą metody lub ReadAsync , wiersza w czasie przy użyciu metody lub ReadLineAsync i całego ciągu przy użyciu ReadLine ReadToEnd metody lub ReadToEndAsync .

Uwaga

Ten typ implementuje IDisposable interfejs, ale w rzeczywistości nie ma żadnych zasobów do usunięcia. Oznacza to, że jego zastosowanie przez bezpośrednie wywołanie lub użycie konstrukcji języka, takiej jak (w języku C#) lub (w języku Dispose() using Using 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...
Utwórz plik tekstowy.	Instrukcje: Zapisywanie tekstu w pliku
Zapisywanie w pliku tekstowym.	Instrukcje: Zapisywanie tekstu w pliku
Odczyt z pliku tekstowego.	Instrukcje: Odczytywanie tekstu z pliku
Dołączanie tekstu 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.
Close()	Zamyka element TextReader i zwalnia wszystkie zasoby systemowe skojarzone z programem TextReader. (Odziedziczone po TextReader)
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()	Nieaktualne. Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
InitializeLifetimeService()	Nieaktualne. Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad 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.
Read(Span<Char>)	Odczytuje znaki z bieżącego czytnika i zapisuje dane w określonym buforze. (Odziedziczone po TextReader)
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(Char[], Int32, Int32)	Odczytuje określoną maksymalną liczbę znaków z bieżącego czytnika tekstu asynchronicznie i zapisuje dane w buforze, zaczynając od określonego indeksu. (Odziedziczone po TextReader)
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.
ReadAsync(Memory<Char>, CancellationToken)	Asynchronicznie odczytuje znaki z bieżącego strumienia do bloku pamięci. (Odziedziczone po TextReader)
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żącego położenia na końcu ciągu wejściowego.
ReadBlock(Span<Char>)	Odczytuje znaki z bieżącego strumienia i zapisuje dane w buforze. (Odziedziczone po TextReader)
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(Char[], Int32, Int32)	Odczytuje określoną maksymalną liczbę znaków z bieżącego czytnika tekstu asynchronicznie i zapisuje dane w buforze, zaczynając od określonego indeksu. (Odziedziczone po TextReader)
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.
ReadBlockAsync(Memory<Char>, CancellationToken)	Asynchronicznie odczytuje znaki z bieżącego strumienia i zapisuje dane w buforze. (Odziedziczone po TextReader)
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()	Odczytuje wiersz znaków asynchronicznie i zwraca dane jako ciąg. (Odziedziczone po TextReader)
ReadLineAsync(CancellationToken)	Odczytuje wiersz znaków asynchronicznie z bieżącego ciągu i zwraca dane jako ciąg.
ReadLineAsync(CancellationToken)	Odczytuje wiersz znaków asynchronicznie i zwraca dane jako ciąg. (Odziedziczone po TextReader)
ReadToEnd()	Odczytuje wszystkie znaki z bieżącego położenia na końcu ciągu i zwraca je jako pojedynczy ciąg.
ReadToEndAsync()	Odczytuje wszystkie znaki z bieżącego położenia na końcu ciągu asynchronicznie i zwraca je jako pojedynczy ciąg.
ReadToEndAsync()	Odczytuje wszystkie znaki z bieżącej pozycji na końcu czytnika tekstu asynchronicznie i zwraca je jako jeden ciąg. (Odziedziczone po TextReader)
ReadToEndAsync(CancellationToken)	Odczytuje wszystkie znaki z bieżącego położenia 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 czytnika tekstu asynchronicznie i zwraca je jako jeden ciąg. (Odziedziczone po TextReader)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

IDisposable.Dispose()

Aby uzyskać opis tego elementu członkowskiego, zobacz Dispose(). (Odziedziczone po TextReader)

Zobacz też

• TextReader
• StringWriter
• We/Wy plików i strumieni
• Instrukcje: Odczytywanie tekstu z pliku
• Instrukcje: Zapisywanie tekstu w pliku