StringReader.Read Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestawy:

netstandard.dll, System.Runtime.dll

Odczytuje następny znak lub następny zestaw znaków z ciągu wejściowego.

Przeciążenia

Nazwa	Opis
Read()	Odczytuje następny znak z ciągu wejściowego i rozwija położenie znaku o jeden znak.
Read(Span<Char>)	Odczytuje wszystkie znaki z ciągu wejściowego, zaczynając od bieżącej pozycji, i przechodzi bieżącą pozycję na końcu ciągu wejściowego.
Read(Char[], Int32, Int32)	Odczytuje blok znaków z ciągu wejściowego i rozwija położenie znaku przez count.

Read()

Źródło:

StringReader.cs

Odczytuje następny znak z ciągu wejściowego i rozwija położenie znaku o jeden znak.

public:
 override int Read();

public override int Read();

override this.Read : unit -> int

Public Overrides Function Read () As Integer

Zwraca

Int32

Następny znak z bazowego ciągu lub -1, jeśli nie są dostępne żadne znaki.

Wyjątki

ObjectDisposedException

Bieżący czytnik jest zamknięty.

Przykłady

Ten przykład kodu jest częścią większego przykładu udostępnionego dla klasy StringReader.

convertedCharacter = (char)intCharacter;
if(convertedCharacter == '.')
{
    strWriter.Write(".\n\n");

    // Bypass the spaces between sentences.
    strReader.Read();
    strReader.Read();
}

convertedCharacter = Convert.ToChar(intCharacter)
If convertedCharacter = "."C Then
    strWriter.Write("." & vbCrLf & vbCrLf)

    ' Bypass the spaces between sentences.
    strReader.Read()
    strReader.Read()

Uwagi

Ta metoda zastępuje metodę TextReader.Read .

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

Aby to zrobić...	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 i dołączanie do pliku dziennika 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: odczytywanie i zapisywanie w nowo utworzonym pliku danych
Zapisywanie w pliku binarnym.	Instrukcje: odczytywanie i zapisywanie w nowo utworzonym pliku danych

Zobacz też

• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

Read(Span<Char>)

Źródło:

StringReader.cs

Odczytuje wszystkie znaki z ciągu wejściowego, zaczynając od bieżącej pozycji, i przechodzi bieżącą pozycję na końcu ciągu wejściowego.

public:
 override int Read(Span<char> buffer);

public override int Read(Span<char> buffer);

override this.Read : Span<char> -> int

Public Overrides Function Read (buffer As Span(Of Char)) As Integer

Parametry

buffer

Span<Char>

Gdy ta metoda zwraca, zawiera znaki odczytane z bieżącego źródła. Jeśli całkowita liczba odczytanych znaków wynosi zero, zakres pozostaje niezmodyfikowany.

Zwraca

Int32

Całkowita liczba znaków odczytanych do buforu.

Wyjątki

ObjectDisposedException

Bieżące wystąpienie czytnika ciągów jest zamknięte.

Read(Char[], Int32, Int32)

Źródło:

StringReader.cs

Odczytuje blok znaków z ciągu wejściowego i rozwija położenie znaku przez count.

public:
 override int Read(cli::array <char> ^ buffer, int index, int count);

public override int Read(char[] buffer, int index, int count);

override this.Read : char[] * int * int -> int

Public Overrides Function Read (buffer As Char(), index As Integer, count As Integer) As Integer

Parametry

buffer

Char[]

Gdy ta metoda zwraca, zawiera określoną tablicę znaków z wartościami między index i (index + count - 1) zastąpionymi znakami odczytanymi z bieżącego źródła.

index

Int32

Indeks początkowy w buforze.

count

Int32

Liczba znaków do odczytania.

Zwraca

Int32

Całkowita liczba znaków odczytanych do buforu. Może to być mniej niż liczba żądanych znaków, jeśli liczba znaków nie jest obecnie dostępna lub zero, jeśli osiągnięto koniec ciągu bazowego.

Wyjątki

ArgumentNullException

Parametr buffer ma wartość null.

ArgumentException

Długość buforu minus index jest mniejsza niż count.

ArgumentOutOfRangeException

index lub count jest ujemny.

ObjectDisposedException

Bieżący czytnik jest zamknięty.

Uwagi

Ta metoda zastępuje metodę TextReader.Read.

Metoda odczytuje do count znaków z StringReader tablicy buffer znaków rozpoczynającej się od pozycji index. Zwraca rzeczywistą liczbę odczytanych znaków lub zero, jeśli osiągnięto koniec ciągu i nie są odczytywane żadne znaki.

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

Aby to zrobić...	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 i dołączanie do pliku dziennika 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: odczytywanie i zapisywanie w nowo utworzonym pliku danych
Zapisywanie w pliku binarnym.	Instrukcje: odczytywanie i zapisywanie w nowo utworzonym pliku danych

Zobacz też

• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku