TextReader.Read 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

從文字讀取器讀取資料。

多載

Read()	自文字讀取器讀取下一個字元，並將字元位置前移一個字元。
Read(Span<Char>)	從目前的讀取器讀取字元，並將資料寫入至指定的緩衝區。
Read(Char[], Int32, Int32)	從目前讀取器讀取指定的最大字元數目，並從指定的索引開始將資料寫入緩衝區。

Read()

Source:

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

傳回

Int32

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

例外狀況

ObjectDisposedException

TextReader 已關閉。

IOException

發生 I/O 錯誤。

備註

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

另請參閱

• Read()
• Read()
• 檔案和資料流程 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

Read(Span<Char>)

Source:

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>

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

傳回

Int32

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

例外狀況

ArgumentNullException

buffer 為 null。

IOException

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

Read(Char[], Int32, Int32)

Source:

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

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

傳回

Int32

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

例外狀況

ArgumentNullException

buffer 為 null。

ArgumentException

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

ArgumentOutOfRangeException

index 或 count 為負。

ObjectDisposedException

TextReader 已關閉。

IOException

發生 I/O 錯誤。

備註

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

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

另請參閱

• Read(Char[], Int32, Int32)
• Read(Char[], Int32, Int32)
• 檔案和資料流程 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案