TextReader.Read Metod

Definition

Namnområde:
System.IO
Sammansättningar:
mscorlib.dll, System.IO.dll
Sammansättningar:
netstandard.dll, System.Runtime.dll
Sammansättning:
System.IO.dll
Sammansättning:
System.Runtime.Extensions.dll
Sammansättning:
mscorlib.dll
Sammansättning:
netstandard.dll

Läser data från textläsaren.

Överlagringar

Name Description
Read()

Läser nästa tecken från textläsaren och flyttar fram teckenpositionen med ett tecken.
Read(Span<Char>)

Läser tecknen från den aktuella läsaren och skriver data till den angivna bufferten.
Read(Char[], Int32, Int32)

Läser ett angivet maximalt antal tecken från den aktuella läsaren och skriver data till en buffert med början vid det angivna indexet.

Read()

Källa:
TextReader.cs
Källa:
TextReader.cs
Källa:
TextReader.cs
Källa:
TextReader.cs
Källa:
TextReader.cs

Läser nästa tecken från textläsaren och flyttar fram teckenpositionen med ett tecken.

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

Returer

Int32

Nästa tecken från textläsaren eller -1 om inga fler tecken är tillgängliga. Standardimplementeringen returnerar -1.

Undantag

ObjectDisposedException

Är TextReader stängd.

IOException

Ett I/O-fel inträffar.

Kommentarer

Klassen TextReader är en abstrakt klass. Därför instansierar du den inte i koden. Ett exempel på hur du Read använder metoden finns i StreamReader.Read metoden.

Se även

Gäller för

Read(Span<Char>)

Källa:
TextReader.cs
Källa:
TextReader.cs
Källa:
TextReader.cs
Källa:
TextReader.cs
Källa:
TextReader.cs

Läser tecknen från den aktuella läsaren och skriver data till den angivna bufferten.

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

Parametrar

buffer
Span<Char>

När den här metoden returnerar, innehåller det angivna intervallet med tecken som ersatts av de tecken som lästs från den aktuella källan.

Returer

Int32

Antalet tecken som har lästs. Talet är mindre än eller lika med buffer längden, beroende på om data är tillgängliga i läsaren. Den här metoden returnerar 0 (noll) om den anropas när inga fler tecken återstår att läsa.

Undantag

ArgumentNullException

buffer är null.

IOException

Antalet tecken som läss från strömmen är större än längden på buffer.

Gäller för

Read(Char[], Int32, Int32)

Källa:
TextReader.cs
Källa:
TextReader.cs
Källa:
TextReader.cs
Källa:
TextReader.cs
Källa:
TextReader.cs

Läser ett angivet maximalt antal tecken från den aktuella läsaren och skriver data till en buffert med början vid det angivna indexet.

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

Parametrar

buffer
Char[]

När den här metoden returnerar innehåller den angivna teckenmatrisen med värdena mellan index och (index + count - 1) ersatta av de tecken som lästs från den aktuella källan.

index
Int32

Den position buffer där du ska börja skriva.

count
Int32

Det maximala antalet tecken som ska läsas. Om slutet av läsaren nås innan det angivna antalet tecken läss in i bufferten returnerar metoden.

Returer

Int32

Antalet tecken som har lästs. Talet är mindre än eller lika countmed , beroende på om data är tillgängliga i läsaren. Den här metoden returnerar 0 (noll) om den anropas när inga fler tecken återstår att läsa.

Undantag

ArgumentNullException

buffer är null.

ArgumentException

Buffertlängden minus index är mindre än count.

ArgumentOutOfRangeException

index eller count är negativ.

ObjectDisposedException

Är TextReader stängd.

IOException

Ett I/O-fel inträffar.

Kommentarer

Den här metoden returneras när antingen count tecken har lästs eller slutet av filen har nåtts. ReadBlock är en blockerande version av den här metoden.

Klassen TextReader är en abstrakt klass. Därför instansierar du den inte i koden. Ett exempel på hur du Read använder metoden finns i StreamReader.Read metoden.

Se även

Gäller för