StringReader Klasa

Definicja

Implementuje TextReader, który odczytuje z ciągu.Implements a TextReader that reads from a string.

public ref class StringReader : System::IO::TextReader
public class StringReader : System.IO.TextReader
[System.Serializable]
public class StringReader : System.IO.TextReader
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class StringReader : System.IO.TextReader
type StringReader = class
    inherit TextReader
Public Class StringReader
Inherits TextReader
Dziedziczenie
StringReader
Dziedziczenie
Atrybuty

Przykłady

Poniższy przykład pokazuje, jak odczytywać cały ciąg asynchronicznie.The following example shows how to read an entire string asynchronously.

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 odczytanie ciągu synchronicznie lub asynchronicznie.StringReader enables you to read a string synchronously or asynchronously. Można odczytać znak z Read lub metody ReadAsync, wiersz w czasie przy użyciu metody ReadLine lub ReadLineAsync oraz cały ciąg przy użyciu ReadToEnd lub metody ReadToEndAsync.You can read a character at a time with the Read or the ReadAsync method, a line at a time using the ReadLine or the ReadLineAsync method and an entire string using the ReadToEnd or the ReadToEndAsync method.

Uwaga

Ten typ implementuje IDisposable interfejsu, ale faktycznie nie ma żadnych zasobów do usunięcia.This type implements the IDisposable interface, but does not actually have any resources to dispose. Oznacza to, że usuwania go poprzez bezpośrednie wywoływanie Dispose() lub przy użyciu języka konstrukcji takich jak using (w C#) lub Using (w języku Visual Basic) nie jest konieczne.This means that disposing it by directly calling Dispose() or by using a language construct such as using (in C#) or Using (in Visual Basic) is not necessary.

W poniższej tabeli przedstawiono przykłady innych typowych lub powiązanych zadań we/wy.The following table lists examples of other typical or related I/O tasks.

Aby to zrobić...To do this... Zobacz przykład w tym temacie...See the example in this topic...
Utwórz plik tekstowy.Create a text file. Instrukcje: zapisywanie tekstu w plikuHow to: Write Text to a File
Zapisz w pliku tekstowym.Write to a text file. Instrukcje: zapisywanie tekstu w plikuHow to: Write Text to a File
Odczytaj plik tekstowy.Read from a text file. Instrukcje: odczytywanie tekstu z plikuHow to: Read Text from a File
Dołącz tekst do pliku.Append text to a file. Instrukcje: otwieranie pliku dziennika i dołączanie do niegoHow to: Open and Append to a Log File

File.AppendText

FileInfo.AppendText
Pobierz rozmiar pliku.Get the size of a file. FileInfo.Length
Pobierz atrybuty pliku.Get the attributes of a file. File.GetAttributes
Ustawianie atrybutów pliku.Set the attributes of a file. File.SetAttributes
Ustal, czy plik istnieje.Determine if a file exists. File.Exists
Odczytaj dane z pliku binarnego.Read from a binary file. Instrukcje: odczyt i zapis we właśnie utworzonym pliku danychHow to: Read and Write to a Newly Created Data File
Zapisz w pliku binarnym.Write to a binary file. Instrukcje: odczyt i zapis we właśnie utworzonym pliku danychHow to: Read and Write to a Newly Created Data File

Konstruktory

StringReader(String)

Inicjuje nowe wystąpienie klasy StringReader, które odczytuje z określonego ciągu.Initializes a new instance of the StringReader class that reads from the specified string.

Metody

Close()

Zamyka StringReader.Closes the StringReader.

CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
Dispose()

Zwalnia wszystkie zasoby używane przez obiekt TextReader.Releases all resources used by the TextReader object.

(Odziedziczone po TextReader)
Dispose(Boolean)

Zwalnia niezarządzane zasoby używane przez StringReader i opcjonalnie zwalnia zarządzane zasoby.Releases the unmanaged resources used by the StringReader and optionally releases the managed resources.

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetLifetimeService()

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
InitializeLifetimeService()

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego obiektu MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
Peek()

Zwraca następny dostępny znak, ale go nie używa.Returns the next available character but does not consume it.

Read()

Odczytuje następny znak z ciągu wejściowego i przesuwa pozycję znaku o jeden znak.Reads the next character from the input string and advances the character position by one character.

Read(Char[], Int32, Int32)

Odczytuje blok znaków z ciągu wejściowego i przesuwa pozycję znaku przez count.Reads a block of characters from the input string and advances the character position by count.

Read(Span<Char>)

Odczytuje wszystkie znaki z ciągu wejściowego, rozpoczynając od bieżącego położenia i przesuwa bieżącą pozycję na koniec ciągu wejściowego.Reads all the characters from the input string, starting at the current position, and advances the current position to the end of the input string.

ReadAsync(Char[], Int32, Int32)

Odczytuje określoną maksymalną liczbę znaków z bieżącego ciągu asynchronicznego i zapisuje dane w buforze, rozpoczynając od określonego indeksu.Reads a specified maximum number of characters from the current string asynchronously and writes the data to a buffer, beginning at the specified index.

ReadAsync(Memory<Char>, CancellationToken)

Asynchronicznie odczytuje wszystkie znaki z ciągu wejściowego, rozpoczynając od bieżącego położenia i przesuwa bieżącą pozycję na koniec ciągu wejściowego.Asynchronously reads all the characters from the input string, starting at the current position, and advances the current position to the end of the input string.

ReadBlock(Char[], Int32, Int32)

Odczytuje określoną maksymalną liczbę znaków z bieżącego czytnika tekstu i zapisuje dane w buforze, rozpoczynając od określonego indeksu.Reads a specified maximum number of characters from the current text reader and writes the data to a buffer, beginning at the specified index.

(Odziedziczone po TextReader)
ReadBlock(Span<Char>)

Odczytuje wszystkie znaki z ciągu wejściowego, rozpoczynając od bieżącego położenia i przesuwa bieżącą pozycję do końca ciągu wejściowego.Reads all the characters from the input string starting at the current position and advances the current position to the end of the input string.

ReadBlockAsync(Char[], Int32, Int32)

Odczytuje określoną maksymalną liczbę znaków z bieżącego ciągu asynchronicznego i zapisuje dane w buforze, rozpoczynając od określonego indeksu.Reads a specified maximum number of characters from the current string asynchronously and writes the data to a buffer, beginning at the specified index.

ReadBlockAsync(Memory<Char>, CancellationToken)

Asynchronicznie odczytuje wszystkie znaki z ciągu wejściowego, rozpoczynając od bieżącego położenia i przesuwa bieżącą pozycję do końca ciągu wejściowego.Asynchronously reads all the characters from the input string starting at the current position and advances the current position to the end of the input string.

ReadLine()

Odczytuje wiersz znaków z bieżącego ciągu i zwraca dane jako ciąg.Reads a line of characters from the current string and returns the data as a string.

ReadLineAsync()

Odczytuje wiersz znaków asynchronicznie z bieżącego ciągu i zwraca dane jako ciąg.Reads a line of characters asynchronously from the current string and returns the data as a string.

ReadToEnd()

Odczytuje wszystkie znaki od bieżącego położenia do końca ciągu i zwraca je jako jeden ciąg.Reads all characters from the current position to the end of the string and returns them as a single string.

ReadToEndAsync()

Odczytuje wszystkie znaki od bieżącego położenia do końca ciągu asynchronicznie i zwraca je jako jeden ciąg.Reads all characters from the current position to the end of the string asynchronously and returns them as a single string.

ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Jawne implementacje interfejsu

IDisposable.Dispose()

Aby uzyskać opis tego elementu członkowskiego, zobacz Dispose().For a description of this member, see Dispose().

(Odziedziczone po TextReader)

Dotyczy

Zobacz też