Udostępnij za pośrednictwem


StringReader Klasa

Definicja

Implementuje element TextReader odczytywany 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
StringReader
Dziedziczenie
Atrybuty

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.

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()
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.

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żącej pozycji 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żą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()

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żą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 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)

Dotyczy

Zobacz też