StringReader.Read 方法

定義

讀取輸入字串中的下一個字元或下一組字元。

多載

名稱 Description
Read()

讀取輸入字串中的下一個字元,並將字元位置前進一個字元。

Read(Span<Char>)

從輸入字串讀取所有字元,從當前位置開始,並將當前位置推進到輸入字串的末尾。

Read(Char[], Int32, Int32)

從輸入字串讀取一組字元,並將字元位置 count前進 。

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

參數

buffer
Span<Char>

當此方法回傳時,包含從當前來源讀取的字元。 若讀取字元總數為零,則該區間保持不變。

傳回

讀取到緩衝區的字元總數。

例外狀況

目前的字串讀取器實例已關閉。

適用於

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

字數的數量。

傳回

讀取到緩衝區的字元總數。 如果目前沒有那麼多字元可用,這個字元數可以少於請求的字元數;如果已經到達底層字串的結尾,則可能為零。

例外狀況

buffernull

緩衝區長度減 index 值小於 count

indexcount 是陰性。

目前的閱讀器已關閉。

備註

這個方法會覆寫 TextReader.Read

該方法將count從 讀取StringReader最多字元,從位置 index開始buffer的字元陣列。 回傳實際讀取的字元數,若已到達字串末尾且未讀取字元則回傳零字元。

下表列出其他典型或相關的 I/O 任務範例。

若要這麼做... 請參閱本主題中的範例...
建立文字檔。 如何:將文字寫入檔案
寫入文字檔。 如何:將文字寫入檔案
從文字檔讀取。 如何:從檔案讀取文字
在檔案中附加文字。 如何:開啟並附加至記錄檔

File.AppendText

FileInfo.AppendText
拿出檔案大小。 FileInfo.Length
取得檔案的屬性。 File.GetAttributes
設定檔案的屬性。 File.SetAttributes
判斷是否有檔案存在。 File.Exists
從二進位檔案讀取。 如何:讀取和寫入新建立的數據檔
寫入二進位檔案。 如何:讀取和寫入新建立的數據檔

另請參閱

適用於