共用方式為


TextReader.Read 方法

定義

從文字讀取器讀取資料。

多載

Read()

自文字讀取器讀取下一個字元,並將字元位置前移一個字元。

Read(Span<Char>)

從目前的讀取器讀取字元,並將資料寫入至指定的緩衝區。

Read(Char[], Int32, Int32)

從目前讀取器讀取指定的最大字元數目,並從指定的索引開始將資料寫入緩衝區。

Read()

來源:
TextReader.cs
來源:
TextReader.cs
來源:
TextReader.cs

自文字讀取器讀取下一個字元,並將字元位置前移一個字元。

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

傳回

文字讀取器的下一個字元;如果不再有字元可供使用,則為 -1。 預設的實作會傳回 -1。

例外狀況

發生 I/O 錯誤。

備註

類別是抽象類別, 因此,您的程式碼中不必將它執行個體化。 如需使用 方法的 Read 範例,請參閱 StreamReader.Read 方法。

另請參閱

適用於

Read(Span<Char>)

來源:
TextReader.cs
來源:
TextReader.cs
來源:
TextReader.cs

從目前的讀取器讀取字元,並將資料寫入至指定的緩衝區。

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

參數

buffer
Span<Char>

當這個方法傳回時,會包含讀取自目前來源之字元所取代的指定字元範圍。

傳回

已經讀取的字元數目。 取決於是否可在讀取器中使用資料,數目會小於或等於 buffer 的長度。 如果不再有字元可供讀取時呼叫,這個方法傳回 0 (零)。

例外狀況

buffernull

從資料流讀取的字元數大於 buffer 的長度。

適用於

Read(Char[], Int32, Int32)

來源:
TextReader.cs
來源:
TextReader.cs
來源:
TextReader.cs

從目前讀取器讀取指定的最大字元數目,並從指定的索引開始將資料寫入緩衝區。

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

參數

buffer
Char[]

當這個方法傳回時,會包含指定的字元陣列,這個陣列具有介於 index 到 (index + count - 1) 之間的值,已由讀取自目前來源的字元所取代。

index
Int32

buffer 中要開始寫入的位置。

count
Int32

要讀取的字元數上限。 如果指定的字元數讀入緩衝區之前,便到達讀取器末端,則方法會返回。

傳回

已經讀取的字元數目。 數目將小於或等於 count,取決於資料是否在讀取器中可供使用。 如果不再有字元可供讀取時呼叫,這個方法傳回 0 (零)。

例外狀況

buffernull

緩衝區長度減去 index 會小於 count

indexcount 為負。

發生 I/O 錯誤。

備註

這個方法會在讀取字元或到達檔案結尾之後 count 傳回。 ReadBlock 是這個方法的封鎖版本。

類別是抽象類別, 因此,您的程式碼中不必將它執行個體化。 如需使用 方法的 Read 範例,請參閱 StreamReader.Read 方法。

另請參閱

適用於