StringReader.Read Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.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żącego położenia, i przechodzi bieżącą pozycję na koniec 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 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 udostępnionego 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...
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łączanie tekstu 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 Stream
• 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żącego położenia, i przechodzi bieżącą pozycję na koniec 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 zwróci wartość , 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 wartość , 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ć mniejsza niż liczba żądanych znaków, jeśli wiele znaków nie jest obecnie dostępnych, lub zero, jeśli osiągnięto koniec bazowego ciągu.

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 metodę TextReader.Read.

Metoda odczytuje maksymalnie count znaki 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 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łączanie tekstu 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 Stream
• Instrukcje: Odczytywanie tekstu z pliku
• Instrukcje: Zapisywanie tekstu w pliku