StringReader Klasa

Definicja

Implementuje element 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.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

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 naraz z Read lub ReadAsync metodą, wierszem w czasie przy użyciu ReadLine ReadLineAsync metody lub i całego ciągu przy użyciu ReadToEnd ReadToEndAsync metody lub.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 interfejs, ale nie ma faktycznie żadnych zasobów do usunięcia.This type implements the IDisposable interface, but does not actually have any resources to dispose. Oznacza to, że usuwanie go przez bezpośrednie wywoływanie Dispose() lub użycie konstrukcji języka, takiej jak using (w języku C#) lub Using (w 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 wykonać tę czynność...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 StringReader klasy, 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.

Close()

Zamyka TextReader i zwalnia wszystkie zasoby systemowe skojarzone z TextReader .Closes the TextReader and releases any system resources associated with the TextReader.

(Odziedziczone po TextReader)
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 TextReader obiekt.Releases all resources used by the TextReader object.

(Odziedziczone po TextReader)
Dispose(Boolean)

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

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.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()
Nieaktualne.

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żące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
InitializeLifetimeService()
Nieaktualne.

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 elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego MarshalByRefObject obiektu.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.

Read(Span<Char>)

Odczytuje znaki z bieżącego czytnika i zapisuje dane w określonym buforze.Reads the characters from the current reader and writes the data to the specified buffer.

(Odziedziczone po TextReader)
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(Char[], Int32, Int32)

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

(Odziedziczone po TextReader)
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.

ReadAsync(Memory<Char>, CancellationToken)

Asynchronicznie odczytuje znaki z bieżącego strumienia do bloku pamięci.Asynchronously reads the characters from the current stream into a memory block.

(Odziedziczone po TextReader)
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.

ReadBlock(Span<Char>)

Odczytuje znaki z bieżącego strumienia i zapisuje dane w buforze.Reads the characters from the current stream and writes the data to a buffer.

(Odziedziczone po TextReader)
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(Char[], Int32, Int32)

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

(Odziedziczone po TextReader)
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.

ReadBlockAsync(Memory<Char>, CancellationToken)

Asynchronicznie odczytuje znaki z bieżącego strumienia i zapisuje je w buforze.Asynchronously reads the characters from the current stream and writes the data to a buffer.

(Odziedziczone po TextReader)
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.

ReadLineAsync()

Odczytuje wiersz znaków asynchronicznie i zwraca dane jako ciąg.Reads a line of characters asynchronously and returns the data as a string.

(Odziedziczone po TextReader)
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.

ReadToEndAsync()

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

(Odziedziczone po TextReader)
ToString()

Zwraca ciąg reprezentujący 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ż