TextReader.Read 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
從文字讀取器讀取資料。
多載
| Read() |
自文字讀取器讀取下一個字元，並將字元位置前移一個字元。 |
| Read(Span<Char>) |
從目前的讀取器讀取字元，並將資料寫入至指定的緩衝區。 |
| Read(Char[], Int32, Int32) |
從目前讀取器讀取指定的最大字元數目，並從指定的索引開始將資料寫入緩衝區。 |
Read()
自文字讀取器讀取下一個字元，並將字元位置前移一個字元。
public:
virtual int Read();public virtual int Read ();abstract member Read : unit -> int
override this.Read : unit -> intPublic Overridable Function Read () As Integer傳回
文字讀取器的下一個字元；如果不再有字元可供使用，則為 -1。 預設的實作會傳回 -1。
例外狀況
發生 I/O 錯誤。
備註
類別是抽象類別， 因此，您的程式碼中不必將它執行個體化。 如需使用 方法的 Read 範例，請參閱 StreamReader.Read 方法。
另請參閱
適用於
Read(Span<Char>)
從目前的讀取器讀取字元，並將資料寫入至指定的緩衝區。
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> -> intPublic Overridable Function Read (buffer As Span(Of Char)) As Integer參數
傳回
已經讀取的字元數目。 取決於是否可在讀取器中使用資料，數目會小於或等於 buffer 的長度。 如果不再有字元可供讀取時呼叫，這個方法傳回 0 (零)。
例外狀況
buffer 為 null。
從資料流讀取的字元數大於 buffer 的長度。
適用於
Read(Char[], Int32, Int32)
從目前讀取器讀取指定的最大字元數目，並從指定的索引開始將資料寫入緩衝區。
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 -> intPublic 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 (零)。
例外狀況
buffer 為 null。
緩衝區長度減去 index 會小於 count。
index 或 count 為負。
發生 I/O 錯誤。
備註
這個方法會在讀取字元或到達檔案結尾之後 count 傳回。 ReadBlock 是這個方法的封鎖版本。
類別是抽象類別， 因此，您的程式碼中不必將它執行個體化。 如需使用 方法的 Read 範例，請參閱 StreamReader.Read 方法。
