TextReader.Read Methode

Definitie

Naamruimte:
System.IO
Assembly's:
mscorlib.dll, System.IO.dll
Assembly:
mscorlib.dll
Assembly:
System.IO.dll
Assembly:
netstandard.dll

Leest gegevens uit de tekstlezer.

Overloads

Name Description
Read()

Hiermee wordt het volgende teken uit de tekstlezer gelezen en wordt de positie van het teken met één teken voorgelezen.
Read(Span<Char>)

Leest de tekens van de huidige lezer en schrijft de gegevens naar de opgegeven buffer.
Read(Char[], Int32, Int32)

Leest een opgegeven maximum aantal tekens van de huidige lezer en schrijft de gegevens naar een buffer, beginnend bij de opgegeven index.

Read()

Hiermee wordt het volgende teken uit de tekstlezer gelezen en wordt de positie van het teken met één teken voorgelezen.

public:
 virtual int Read();
public virtual int Read();
abstract member Read : unit -> int
override this.Read : unit -> int
Public Overridable Function Read () As Integer

Retouren

Int32

Het volgende teken uit de tekstlezer of -1 als er geen tekens meer beschikbaar zijn. De standaard implementatie retourneert -1.

Uitzonderingen

ObjectDisposedException

De TextReader is gesloten.

IOException

Er treedt een I/O-fout op.

Opmerkingen

De TextReader klasse is een abstracte klasse. Daarom maakt u deze niet instantiëren in uw code. Zie de methode voor een voorbeeld van het gebruik van de ReadStreamReader.Read methode.

Zie ook

Van toepassing op

Read(Span<Char>)

Leest de tekens van de huidige lezer en schrijft de gegevens naar de opgegeven buffer.

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

Parameters

buffer
Span<Char>

Wanneer deze methode wordt geretourneerd, bevat de opgegeven reeks tekens die worden vervangen door de tekens die uit de huidige bron worden gelezen.

Retouren

Int32

Het aantal tekens dat is gelezen. Het getal is kleiner dan of gelijk aan de buffer lengte, afhankelijk van of de gegevens beschikbaar zijn in de lezer. Deze methode retourneert 0 (nul) als deze wordt aangeroepen wanneer er geen tekens meer worden gelezen.

Uitzonderingen

ArgumentNullException

buffer is null.

IOException

Het aantal tekens dat uit de stroom wordt gelezen, is groter dan de lengte van de bufferstroom.

Van toepassing op

Read(Char[], Int32, Int32)

Leest een opgegeven maximum aantal tekens van de huidige lezer en schrijft de gegevens naar een buffer, beginnend bij de opgegeven index.

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

Parameters

buffer
Char[]

Wanneer deze methode wordt geretourneerd, bevat de opgegeven tekenmatrix met de waarden tussen index en (index + count - 1) vervangen door de tekens die uit de huidige bron worden gelezen.

index
Int32

De positie buffer waarin moet worden geschreven.

count
Int32

Het maximum aantal tekens dat moet worden gelezen. Als het einde van de lezer wordt bereikt voordat het opgegeven aantal tekens in de buffer wordt gelezen, retourneert de methode.

Retouren

Int32

Het aantal tekens dat is gelezen. Het getal is kleiner dan of gelijk aan count, afhankelijk van of de gegevens beschikbaar zijn in de lezer. Deze methode retourneert 0 (nul) als deze wordt aangeroepen wanneer er geen tekens meer worden gelezen.

Uitzonderingen

ArgumentNullException

buffer is null.

ArgumentException

De bufferlengte min index is kleiner dan count.

ArgumentOutOfRangeException

index of count is negatief.

ObjectDisposedException

De TextReader is gesloten.

IOException

Er treedt een I/O-fout op.

Opmerkingen

Deze methode retourneert nadat de count tekens zijn gelezen of het einde van het bestand is bereikt. ReadBlock is een blokkerende versie van deze methode.

De TextReader klasse is een abstracte klasse. Daarom maakt u deze niet instantiëren in uw code. Zie de methode voor een voorbeeld van het gebruik van de ReadStreamReader.Read methode.

Zie ook

Van toepassing op