StringReader.Read 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

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

多載

Read()	自輸入字串讀取下一個字元，並將字元位置前移一個字元。
Read(Span<Char>)	從目前位置開始，讀取輸入字串中的所有字元，並將目前位置往前移至輸入字串的結尾。
Read(Char[], Int32, Int32)	自輸入字串讀取字元區塊，並將字元位置前移 count 個字元。

Read()

來源:

StringReader.cs

自輸入字串讀取下一個字元，並將字元位置前移一個字元。

public:
 override int Read();

public override int Read ();

override this.Read : unit -> int

Public Overrides Function Read () As Integer

傳回

Int32

基礎字串的下一個字元；如果不再有字元可供使用，則為 -1。

例外狀況

ObjectDisposedException

目前的讀取器已關閉。

範例

此程式代碼範例是針對 類別提供的較大範例的 StringReader 一部分。

convertedCharacter = Convert::ToChar( intCharacter );
if ( convertedCharacter == '.' )
{
   strWriter->Write(  ".\n\n" );
   
   // Bypass the spaces between sentences.
   strReader->Read();
   strReader->Read();
}

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
從二進位檔讀取。	作法：讀取和寫入新建立的資料檔案
寫入二進位檔。	作法：讀取和寫入新建立的資料檔案

另請參閱

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

Read(Span<Char>)

來源:

StringReader.cs

從目前位置開始，讀取輸入字串中的所有字元，並將目前位置往前移至輸入字串的結尾。

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>

當這個方法傳回時，會包含讀取自目前來源的字元。 如果讀取的字元總數為零，則範圍會保持不變。

傳回

Int32

讀入緩衝區的字元總數。

例外狀況

ObjectDisposedException

目前的字串讀取器執行個體已關閉。

Read(Char[], Int32, Int32)

來源:

StringReader.cs

自輸入字串讀取字元區塊，並將字元位置前移 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

要讀取的字元數。

傳回

Int32

讀入緩衝區的字元總數。 如果目前無法提供那麼多的字元數，則這個數目可能小於所要求的字元數，或如果已經到達基礎字串的末端，則為零。

例外狀況

ArgumentNullException

buffer 為 null。

ArgumentException

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

ArgumentOutOfRangeException

index 或 count 為負。

ObjectDisposedException

目前的讀取器已關閉。

備註

這個方法會覆寫 TextReader.Read。

方法會從 StringReaderbuffer 讀取 到count從 位置index開始的字元陣列。 傳回讀取的實際字元數，如果已到達字串結尾且未讀取任何字元，則傳回零。

下表列出其他一般或相關 I/O 工作的範例。

作法...	請參閱這個主題中的範例…
建立文字檔	作法：將文字寫入檔案
寫入文字檔。	作法：將文字寫入檔案
從文字檔讀取。	作法：讀取檔案中的文字
將文字附加至檔案。	作法：開啟並附加至記錄檔 File.AppendText FileInfo.AppendText
取得檔案的大小。	FileInfo.Length
取得檔案的屬性。	File.GetAttributes
設定檔案的屬性。	File.SetAttributes
判斷檔案是否存在。	File.Exists
從二進位檔讀取。	作法：讀取和寫入新建立的資料檔案
寫入二進位檔。	作法：讀取和寫入新建立的資料檔案

另請參閱

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