StringReader.Read 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
讀取輸入字串中的下一個字元或下一組字元。
多載
| 名稱 | Description |
|---|---|
| Read() |
讀取輸入字串中的下一個字元,並將字元位置前進一個字元。 |
| Read(Span<Char>) |
從輸入字串讀取所有字元,從當前位置開始,並將當前位置推進到輸入字串的末尾。 |
| Read(Char[], Int32, Int32) |
從輸入字串讀取一組字元,並將字元位置 |
Read()
讀取輸入字串中的下一個字元,並將字元位置前進一個字元。
public:
override int Read();
public override int Read();
override this.Read : unit -> int
Public Overrides Function Read () As Integer
傳回
從底層字串中取下一個字元,若無更多字元則為 -1。
例外狀況
目前的閱讀器已關閉。
範例
此程式碼範例是本類別更大範例 StringReader 的一部分。
convertedCharacter = (char)intCharacter;
if(convertedCharacter == '.')
{
strWriter.Write(".\n\n");
// Bypass the spaces between sentences.
strReader.Read();
strReader.Read();
}
convertedCharacter = Convert.ToChar(intCharacter)
If convertedCharacter = "."C Then
strWriter.Write("." & vbCrLf & vbCrLf)
' Bypass the spaces between sentences.
strReader.Read()
strReader.Read()
備註
此方法會覆蓋該方法。TextReader.Read
下表列出其他典型或相關的 I/O 任務範例。
| 若要這麼做... | 請參閱本主題中的範例... |
|---|---|
| 建立文字檔。 | 如何:將文字寫入檔案 |
| 寫入文字檔。 | 如何:將文字寫入檔案 |
| 從文字檔讀取。 | 如何:從檔案讀取文字 |
| 在檔案中附加文字。 |
如何:開啟並附加至記錄檔 File.AppendText FileInfo.AppendText |
| 拿出檔案大小。 | FileInfo.Length |
| 取得檔案的屬性。 | File.GetAttributes |
| 設定檔案的屬性。 | File.SetAttributes |
| 判斷是否有檔案存在。 | File.Exists |
| 從二進位檔案讀取。 | 如何:讀取和寫入新建立的數據檔 |
| 寫入二進位檔案。 | 如何:讀取和寫入新建立的數據檔 |
另請參閱
適用於
Read(Span<Char>)
從輸入字串讀取所有字元,從當前位置開始,並將當前位置推進到輸入字串的末尾。
public:
override int Read(Span<char> buffer);
public override int Read(Span<char> buffer);
override this.Read : Span<char> -> int
Public Overrides Function Read (buffer As Span(Of Char)) As Integer
參數
傳回
讀取到緩衝區的字元總數。
例外狀況
目前的字串讀取器實例已關閉。
適用於
Read(Char[], Int32, Int32)
從輸入字串讀取一組字元,並將字元位置 count前進 。
public:
override int Read(cli::array <char> ^ buffer, int index, int count);
public override int Read(char[] buffer, int index, int count);
override this.Read : char[] * int * int -> int
Public Overrides Function Read (buffer As Char(), index As Integer, count As Integer) As Integer
參數
- buffer
- Char[]
當此方法回傳時,包含指定的字元陣列,且介於 index 和 之間的index + count 值( - 1)被從當前來源讀取的字元取代。
- index
- Int32
緩衝區的起始索引。
- count
- Int32
字數的數量。
傳回
讀取到緩衝區的字元總數。 如果目前沒有那麼多字元可用,這個字元數可以少於請求的字元數;如果已經到達底層字串的結尾,則可能為零。
例外狀況
buffer 是 null。
緩衝區長度減 index 值小於 count。
index 或 count 是陰性。
目前的閱讀器已關閉。
備註
這個方法會覆寫 TextReader.Read。
該方法將count從 讀取StringReader最多字元,從位置 index開始buffer的字元陣列。 回傳實際讀取的字元數,若已到達字串末尾且未讀取字元則回傳零字元。
下表列出其他典型或相關的 I/O 任務範例。
| 若要這麼做... | 請參閱本主題中的範例... |
|---|---|
| 建立文字檔。 | 如何:將文字寫入檔案 |
| 寫入文字檔。 | 如何:將文字寫入檔案 |
| 從文字檔讀取。 | 如何:從檔案讀取文字 |
| 在檔案中附加文字。 |
如何:開啟並附加至記錄檔 File.AppendText FileInfo.AppendText |
| 拿出檔案大小。 | FileInfo.Length |
| 取得檔案的屬性。 | File.GetAttributes |
| 設定檔案的屬性。 | File.SetAttributes |
| 判斷是否有檔案存在。 | File.Exists |
| 從二進位檔案讀取。 | 如何:讀取和寫入新建立的數據檔 |
| 寫入二進位檔案。 | 如何:讀取和寫入新建立的數據檔 |