ReadSingle Method

BinaryReader.ReadSingle Method ()


Reads a 4-byte floating point value from the current stream and advances the current position of the stream by four bytes.

Namespace:   System.IO
Assembly:  mscorlib (in mscorlib.dll)

public virtual float ReadSingle()

Return Value

Type: System.Single

A 4-byte floating point value read from the current stream.

Exception Condition

The end of the stream is reached.


The stream is closed.


An I/O error occurs.

BinaryReader does not restore the file position after an unsuccessful read.

BinaryReader reads this data type in little-endian format.

For a list of common I/O tasks, see Common I/O Tasks.

The following code example demonstrates how to store and retrieve application settings in a file.

using System;
using System.IO;

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

    static void Main()

    public static void WriteDefaultValues()
        using (BinaryWriter writer = new BinaryWriter(File.Open(fileName, FileMode.Create)))

    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);

Universal Windows Platform
Available since 4.5
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
© 2015 Microsoft