TextReader.Read 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
讀取文字閱讀器的資料。
多載
| 名稱 | Description |
|---|---|
| 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。
例外狀況
那是 TextReader 關門的。
發生 I/O 錯誤。
備註
這個 TextReader 類別是抽象類別。 因此，你不會在程式碼中實例化它。 關於使用此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 是陰性。
那是 TextReader 關門的。
發生 I/O 錯誤。
備註
此方法在讀取字元或檔案結束後 count 返回。
ReadBlock 是此方法的阻擋版本。
這個 TextReader 類別是抽象類別。 因此，你不會在程式碼中實例化它。 關於使用此Read方法的範例，請參見該方法。StreamReader.Read
