TextReader.Read Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Odczytuje dane z czytnika tekstu.
Przeciążenia
Read() |
Odczytuje następny znak z czytnika tekstu i rozwija położenie znaku o jeden znak. |
Read(Span<Char>) |
Odczytuje znaki z bieżącego czytnika i zapisuje dane w określonym buforze. |
Read(Char[], Int32, Int32) |
Odczytuje określoną maksymalną liczbę znaków z bieżącego czytnika i zapisuje dane w buforze, począwszy od określonego indeksu. |
Read()
- Source:
- TextReader.cs
- Source:
- TextReader.cs
- Source:
- TextReader.cs
Odczytuje następny znak z czytnika tekstu i rozwija położenie znaku o jeden znak.
public:
virtual int Read();
public virtual int Read ();
abstract member Read : unit -> int
override this.Read : unit -> int
Public Overridable Function Read () As Integer
Zwraca
Następny znak z czytnika tekstu lub -1, jeśli więcej znaków nie jest dostępnych. Domyślna implementacja zwraca wartość -1.
Wyjątki
Element TextReader jest zamknięty.
Wystąpi błąd We/Wy.
Uwagi
Klasa TextReader jest abstrakcyjną klasą. W związku z tym, nie tworzy się obiektu w kodzie. Aby zapoznać się z przykładem użycia Read metody , zobacz metodę StreamReader.Read .
Zobacz też
- Read()
- Read()
- We/Wy pliku i strumienia
- Instrukcje: Odczytywanie tekstu z pliku
- Instrukcje: Zapisywanie tekstu w pliku
Dotyczy
Read(Span<Char>)
- Source:
- TextReader.cs
- Source:
- TextReader.cs
- Source:
- TextReader.cs
Odczytuje znaki z bieżącego czytnika i zapisuje dane w określonym buforze.
public:
virtual int Read(Span<char> buffer);
public virtual int Read (Span<char> buffer);
abstract member Read : Span<char> -> int
override this.Read : Span<char> -> int
Public Overridable Function Read (buffer As Span(Of Char)) As Integer
Parametry
Gdy ta metoda zwraca wartość , zawiera określony zakres znaków zamienione przez znaki odczytane z bieżącego źródła.
Zwraca
Liczba odczytanych znaków. Liczba będzie mniejsza lub równa buffer
długości, w zależności od tego, czy dane są dostępne w czytniku. Ta metoda zwraca wartość 0 (zero), jeśli jest wywoływana, gdy nie ma więcej znaków do odczytania.
Wyjątki
buffer
to null
.
Liczba znaków odczytanych ze strumienia jest większa niż długość obiektu buffer
.
Dotyczy
Read(Char[], Int32, Int32)
- Source:
- TextReader.cs
- Source:
- TextReader.cs
- Source:
- TextReader.cs
Odczytuje określoną maksymalną liczbę znaków z bieżącego czytnika i zapisuje dane w buforze, począwszy od określonego indeksu.
public:
virtual int Read(cli::array <char> ^ buffer, int index, int count);
public virtual int Read (char[] buffer, int index, int count);
abstract member Read : char[] * int * int -> int
override this.Read : char[] * int * int -> int
Public Overridable 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
Pozycja, w buffer
której należy rozpocząć pisanie.
- count
- Int32
Maksymalna liczba znaków do odczytania. Jeśli osiągnięto koniec czytnika, zanim określona liczba znaków zostanie odczytana do buforu, metoda zwróci wartość .
Zwraca
Liczba odczytanych znaków. Liczba będzie mniejsza lub równa count
, w zależności od tego, czy dane są dostępne w czytniku. Ta metoda zwraca wartość 0 (zero), jeśli jest wywoływana, gdy nie ma więcej znaków do odczytania.
Wyjątki
buffer
to null
.
Długość buforu minus index
jest mniejsza niż count
.
index
lub count
jest ujemny.
Element TextReader jest zamknięty.
Wystąpi błąd We/Wy.
Uwagi
Ta metoda zwraca wartość po count
odczytaniu znaków lub osiągnięciu końca pliku. ReadBlock jest zablokowaną wersją tej metody.
Klasa TextReader jest abstrakcyjną klasą. W związku z tym, nie tworzy się obiektu w kodzie. Aby zapoznać się z przykładem użycia Read metody , zobacz metodę StreamReader.Read .
Zobacz też
- Read(Char[], Int32, Int32)
- Read(Char[], Int32, Int32)
- We/Wy pliku i strumienia
- Instrukcje: Odczytywanie tekstu z pliku
- Instrukcje: Zapisywanie tekstu w pliku
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla