BinaryReader.ReadChars メソッド

.NET Framework クラス ライブラリ リファレンス

BinaryReader.ReadChars メソッド

現在のストリームから count で指定した文字数分の文字を読み取り、そのデータを文字配列として返します。使用した Encoding とストリームから読み取った特定の文字に従って現在位置を進めます。

名前空間: System.IO
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 ReadChars ( _
    count As Integer _
) As Char()

Visual Basic (使用法)

Dim instance As BinaryReader
Dim count As Integer
Dim returnValue As Char()

returnValue = instance.ReadChars(count)

C#

public virtual char[] ReadChars (
    int count
)

C++

public:
virtual array<wchar_t>^ ReadChars (
    int count
)

J#

public char[] ReadChars (
    int count
)

JScript

public function ReadChars (
    count : int
) : char[]

パラメータ

count

読み込む文字数。

戻り値
基になるストリームから読み取ったデータが格納されている文字配列。ストリームの末尾に到達した場合は、要求された文字数より小さくなることがあります。

例外

例外の種類	条件
EndOfStreamException	ストリームの末尾に到達しました。
ObjectDisposedException	ストリームが閉じられました。
IOException	I/O エラーが発生しました。
ArgumentOutOfRangeException	count が負の値です。

解説

BinaryReader は、読み取りが失敗した後にファイルを元に位置に戻しません。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキスト ファイルを作成する。	方法 : ファイルにテキストを書き込む
テキスト ファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキスト ファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログ ファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリ ファイルから読み取る。	方法 : 新しく作成されたデータ ファイルに対して読み書きする
バイナリ ファイルに書き込む。	方法 : 新しく作成されたデータ ファイルに対して読み書きする

使用例

メモリをバッキング ストアとして使用してデータを読み書きする方法の例を次に示します。

Visual Basic

Imports System
Imports System.IO

Public Class BinaryRW

    Shared Sub Main()
    
        Dim invalidPathChars() As Char
 = Path.InvalidPathChars
        Dim memStream As new
 MemoryStream()
        Dim binWriter As New
 BinaryWriter(memStream)

        ' Write to memory.
        binWriter.Write("Invalid file path characters are: ")
        binWriter.Write(Path.InvalidPathChars)

        ' Create the reader using the same MemoryStream 
        ' as used with the writer.
        Dim binReader As New
 BinaryReader(memStream)

        ' Set Position to the beginning of the stream.
        memStream.Position = 0

        ' Read the data from memory and write it to the console.
        Console.Write(binReader.ReadString())
        Console.WriteLine(binReader.ReadChars( _
            CInt(memStream.Length - memStream.Position)))
    
    End Sub
End Class

C#

using System;
using System.IO;

class BinaryRW
{
    static void Main()
    {
        char[] invalidPathChars = Path.InvalidPathChars;
        MemoryStream memStream = new MemoryStream();
        BinaryWriter binWriter = new BinaryWriter(memStream);

        // Write to memory.
        binWriter.Write("Invalid file path characters are: ");
        binWriter.Write(Path.InvalidPathChars);

        // Create the reader using the same MemoryStream 
        // as used with the writer.
        BinaryReader binReader = new BinaryReader(memStream);

        // Set Position to the beginning of the stream.
        memStream.Position = 0;

        // Read the data from memory and write it to the console.
        Console.Write(binReader.ReadString());
        Console.WriteLine(binReader.ReadChars(
            (int)(memStream.Length - memStream.Position)));
    }
}

C++

using namespace System;
using namespace System::IO;
int main()
{
   array<Char>^invalidPathChars = Path::InvalidPathChars;
   MemoryStream^ memStream = gcnew MemoryStream;
   BinaryWriter^ binWriter = gcnew BinaryWriter( memStream );
   
   // Write to memory.
   binWriter->Write( "Invalid file path characters are: " );
   binWriter->Write( Path::InvalidPathChars );
   
   // Create the reader using the same MemoryStream 
   // as used with the writer.
   BinaryReader^ binReader = gcnew BinaryReader( memStream );
   
   // Set Position to the beginning of the stream.
   binReader->BaseStream->Position = 0;
   
   // Read the data from memory and write it to the console.
   Console::Write( binReader->ReadString() );
   Console::WriteLine( binReader->ReadChars( (int)(memStream->Length
 - memStream->Position) ) );
}

J#

import System.*;
import System.IO.*;

class BinaryRW
{   
    public static void main(String[]
 args)
    {
        char invalidPathChars[] = Path.InvalidPathChars;
        MemoryStream memStream = new MemoryStream();
        BinaryWriter binWriter = new BinaryWriter(memStream);

        // Write to memory.
        binWriter.Write("Invalid file path characters are: ");
        binWriter.Write(Path.InvalidPathChars);

        // Create the reader using the same MemoryStream 
        // as used with the writer.
        BinaryReader binReader = new BinaryReader(memStream);

        // Set Position to the beginning of the stream.
        memStream.set_Position(0);

        // Read the data from memory and write it to the console.
        Console.Write(binReader.ReadString());
        Console.WriteLine(binReader.ReadChars((int)
            (memStream.get_Length() - memStream.get_Position())));
    } //main
} //BinaryRW

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
BinaryReader クラス
BinaryReader メンバ
System.IO 名前空間
Encoding
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む