この記事は機械翻訳されています。英語版の記事を表示するには、[英語] のチェック ボックスをオンにしてください。また、テキストにマウス ポインターを合わせると、ポップアップ ウィンドウに英語のテキストを表示することもできます。
翻訳
英語

BinaryReader クラス

 

公開日: 2016年10月

プリミティブ データ型を特定のエンコーディングのバイナリ値として読み取ります。

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

System.Object
  System.IO.BinaryReader

[ComVisibleAttribute(true)]
public class BinaryReader : IDisposable

名前説明
System_CAPS_pubmethodBinaryReader(Stream)

指定したストリームに基づき、UTF-8 エンコーディングを使用する BinaryReader クラスの新しいインスタンスを初期化します。

System_CAPS_pubmethodBinaryReader(Stream, Encoding)

指定したストリームと文字エンコーディングに基づいて、BinaryReader クラスの新しいインスタンスを初期化します。

System_CAPS_pubmethodBinaryReader(Stream, Encoding, Boolean)

指定したストリームと文字エンコーディングに基づいて BinaryReader クラスの新しいインスタンスを初期化し、必要に応じて、ストリームを開いたままにします。

名前説明
System_CAPS_pubpropertyBaseStream

BinaryReader の基になるストリームへのアクセスを公開します。

名前説明
System_CAPS_pubmethodClose()

現在のリーダーと基になるストリームをクローズします。

System_CAPS_pubmethodDispose()

BinaryReader クラスの現在のインスタンスによって使用されているすべてのリソースを解放します。

System_CAPS_protmethodDispose(Boolean)

BinaryReader クラスによって使用されているアンマネージ リソースを解放し、オプションでマネージ リソースも解放します。

System_CAPS_pubmethodEquals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。(Object から継承されます。)

System_CAPS_protmethodFillBuffer(Int32)

指定したバイト数分だけストリームから読み取ったバイトを内部バッファーに格納します。

System_CAPS_protmethodFinalize()

オブジェクトがガベージ コレクションにより収集される前に、そのオブジェクトがリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)

System_CAPS_pubmethodGetHashCode()

既定のハッシュ関数として機能します。(Object から継承されます。)

System_CAPS_pubmethodGetType()

現在のインスタンスの Type を取得します。(Object から継承されます。)

System_CAPS_protmethodMemberwiseClone()

現在の Object の簡易コピーを作成します。(Object から継承されます。)

System_CAPS_pubmethodPeekChar()

読み取り可能な次の文字を返します。バイトの位置または文字の位置は変化しません。

System_CAPS_pubmethodRead()

基になるストリームから文字を読み取り、使用した Encoding とストリームから読み取った特定の文字に従ってストリームの現在位置を進めます。

System_CAPS_pubmethodRead(Byte[], Int32, Int32)

バイト配列内の指定された位置を開始点として、ストリームから指定されたバイト数を読み取ります。

System_CAPS_pubmethodRead(Char[], Int32, Int32)

文字配列内の指定された位置を開始点として、ストリームから指定された文字数を読み取ります。

System_CAPS_protmethodRead7BitEncodedInt()

32 ビット整数を圧縮形式で読み取ります。

System_CAPS_pubmethodReadBoolean()

現在のストリームから Boolean 値を読み取り、ストリームの現在位置を 1 バイトだけ進めます。

System_CAPS_pubmethodReadByte()

現在のストリームから次のバイトを読み取り、ストリームの現在位置を 1 バイトだけ進めます。

System_CAPS_pubmethodReadBytes(Int32)

現在のストリームから指定されたバイト数をバイト配列に読み取り、そのバイト数だけストリーム内の現在位置を進めます。

System_CAPS_pubmethodReadChar()

現在のストリームの次の文字を読み取り、使用した Encoding とストリームから読み取った特定の文字に従ってストリームの現在位置を進めます。

System_CAPS_pubmethodReadChars(Int32)

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

System_CAPS_pubmethodReadDecimal()

現在のストリームから 10 進数値を読み取り、ストリームの現在位置を 16 バイトだけ進めます。

System_CAPS_pubmethodReadDouble()

現在のストリームから 8 バイト浮動小数点値を読み取り、ストリームの現在位置を 8 バイトだけ進めます。

System_CAPS_pubmethodReadInt16()

現在のストリームから 2 バイト符号付き整数を読み取り、ストリームの現在位置を 2 バイトだけ進めます。

System_CAPS_pubmethodReadInt32()

現在のストリームから 4 バイト符号付き整数を読み取り、ストリームの現在位置を 4 バイトだけ進めます。

System_CAPS_pubmethodReadInt64()

現在のストリームから 8 バイト符号付き整数を読み取り、ストリームの現在位置を 8 バイトだけ進めます。

System_CAPS_pubmethodReadSByte()

現在のストリームから符号付きバイトを読み取り、ストリームの現在位置を 1 バイトだけ進めます。

System_CAPS_pubmethodReadSingle()

現在のストリームから 4 バイト浮動小数点値を読み取り、ストリームの現在位置を 4 バイトだけ進めます。

System_CAPS_pubmethodReadString()

現在のストリームから 1 つの文字列を読み取ります。 ストリームの文字列は、7 ビットごとにエンコードされた文字列の長さが先頭に付加されています。

System_CAPS_pubmethodReadUInt16()

リトル エンディアン エンコーディングを使用して現在のストリームから 2 バイト符号なし整数を読み取り、ストリームの位置を 2 バイトだけ進めます。

System_CAPS_pubmethodReadUInt32()

現在のストリームから 4 バイト符号なし整数を読み取り、ストリームの位置を 4 バイトだけ進めます。

System_CAPS_pubmethodReadUInt64()

現在のストリームから 8 バイト符号なし整数を読み取り、ストリームの位置を 8 バイトだけ進めます。

System_CAPS_pubmethodToString()

現在のオブジェクトを表す文字列を返します。 (Object から継承されます。)

BinaryReader クラス プリミティブ データ型のストリームからの読み取りを簡略化するメソッドを提供します。 たとえば、使用、 ReadBoolean メソッドをブール値として次のバイトを読み取り、1 バイトをストリームの現在位置を進めます。 クラスには、さまざまなデータ型をサポートする読み取りメソッドが含まれています。

新しいインスタンスを作成するときに、 BinaryReader 、クラスを読み取ったり、ストリームを提供し、必要に応じてエンコードの種類を指定して破棄した後に、ストリームのままにするかどうかを開く、 BinaryReader オブジェクトです。 エンコードの種類を指定しない場合は、utf-8 が使用されます。

System_CAPS_important重要

この型は、 IDisposable インターフェイスです。 型の使用が完了したらを直接または間接的にその破棄する必要があります。 型を直接に破棄するには、try/catch ブロックで Dispose メソッドを呼び出します。 間接的に破棄する場合は、 using (C#) または Using (Visual Basic) 言語構成要素を使用します。 詳細については、IDisposable インターフェイスに関するトピックの "IDisposable を実装するオブジェクトを使用する" セクションを参照してください 。

次のコード例では、保管およびファイル内のアプリケーション設定を取得する方法を示します。

using System;
using System.IO;

class ConsoleApplication
{
    const string fileName = "AppSettings.dat";

    static void Main()
    {
        WriteDefaultValues();
        DisplayValues();
    }

    public static void WriteDefaultValues()
    {
        using (BinaryWriter writer = new BinaryWriter(File.Open(fileName, FileMode.Create)))
        {
            writer.Write(1.250F);
            writer.Write(@"c:\Temp");
            writer.Write(10);
            writer.Write(true);
        }
    }

    public static void DisplayValues()
    {
        float aspectRatio;
        string tempDirectory;
        int autoSaveTime;
        bool showStatusBar;

        if (File.Exists(fileName))
        {
            using (BinaryReader reader = new BinaryReader(File.Open(fileName, FileMode.Open)))
            {
                aspectRatio = reader.ReadSingle();
                tempDirectory = reader.ReadString();
                autoSaveTime = reader.ReadInt32();
                showStatusBar = reader.ReadBoolean();
            }

            Console.WriteLine("Aspect ratio set to: " + aspectRatio);
            Console.WriteLine("Temp directory is: " + tempDirectory);
            Console.WriteLine("Auto save time set to: " + autoSaveTime);
            Console.WriteLine("Show status bar: " + showStatusBar);
        }
    }
}

ユニバーサル Windows プラットフォーム
8 以降で使用可能
.NET Framework
1.1 以降で使用可能
ポータブル クラス ライブラリ
サポート対象: 移植可能 .NET プラットフォーム
Silverlight
2.0 以降で使用可能
Windows Phone Silverlight
7.0 以降で使用可能
Windows Phone
8.1 以降で使用可能

この型のパブリック static (Visual Basic では Shared ) メンバーはスレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。

トップに戻る
表示: