StringReader.Read Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.IO.dll

Zestaw:

System.Runtime.dll

Zestaw:

System.Runtime.Extensions.dll

Zestaw:

mscorlib.dll

Zestaw:

netstandard.dll

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

Przeciążenia

Read()	Odczytuje następny znak z ciągu wejściowego i rozwija pozycję znaku o jeden znak.
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(Char[], Int32, Int32)	Odczytuje blok znaków z ciągu wejściowego i rozwija pozycję znaku przez .count

Read()

Odczytuje następny znak z ciągu wejściowego i rozwija pozycję 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 podanego StringReader dla klasy.

convertedCharacter = Convert::ToChar( intCharacter );
if ( convertedCharacter == '.' )
{
   strWriter->Write(  ".\n\n" );
   
   // Bypass the spaces between sentences.
   strReader->Read();
   strReader->Read();
}

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 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łą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

Zobacz też

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

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.

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 zostanie zwrócona, zawiera znaki odczytywane z bieżącego źródła. Jeśli całkowita liczba znaków odczytanych 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)

Odczytuje blok znaków z ciągu wejściowego i rozwija pozycję 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 odczytywanymi 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 wiele znaków nie jest obecnie dostępnych, lub zero, jeśli osiągnięto koniec ciągu bazowego.

Wyjątki

ArgumentNullException

buffer to 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 TextReader.Read.

Metoda odczytuje maksymalnie count znaki z StringReader tablicy znaków rozpoczynającej buffer 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 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łą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

Zobacz też

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