BinaryWriter Constructors

Reference

Definition

Namespace:: System.IO

Assemblies:: mscorlib.dll, System.IO.dll

Assemblies:: netstandard.dll, System.Runtime.dll

Assembly:: System.IO.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Initializes a new instance of the BinaryWriter class that writes to a stream.

Overloads

BinaryWriter()	Initializes a new instance of the BinaryWriter class that writes to a stream.
BinaryWriter(Stream)	Initializes a new instance of the BinaryWriter class based on the specified stream and using UTF-8 encoding.
BinaryWriter(Stream, Encoding)	Initializes a new instance of the BinaryWriter class based on the specified stream and character encoding.
BinaryWriter(Stream, Encoding, Boolean)	Initializes a new instance of the BinaryWriter class based on the specified stream and character encoding, and optionally leaves the stream open.

BinaryWriter()

Source:: BinaryWriter.cs

Source:: BinaryWriter.cs

Source:: BinaryWriter.cs

Initializes a new instance of the BinaryWriter class that writes to a stream.

protected:
 BinaryWriter();

protected BinaryWriter();

Protected Sub New ()

Remarks

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

Applies to

.NET 10 och andra versioner

Produkt	Versioner
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

BinaryWriter(Stream)

Source:: BinaryWriter.cs

Source:: BinaryWriter.cs

Source:: BinaryWriter.cs

Initializes a new instance of the BinaryWriter class based on the specified stream and using UTF-8 encoding.

public:
 BinaryWriter(System::IO::Stream ^ output);

public BinaryWriter(System.IO.Stream output);

new System.IO.BinaryWriter : System.IO.Stream -> System.IO.BinaryWriter

Public Sub New (output As Stream)

Parameters

output: Stream

The output stream.

Exceptions

ArgumentException

The stream does not support writing or is already closed.

ArgumentNullException

output is null.

Examples

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

using System;
using System.IO;
using System.Text;

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

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

    public static void WriteDefaultValues()
    {
        using (var stream = File.Open(fileName, FileMode.Create))
        {
            using (var writer = new BinaryWriter(stream, Encoding.UTF8, false))
            {
                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 (var stream = File.Open(fileName, FileMode.Open))
            {
                using (var reader = new BinaryReader(stream, Encoding.UTF8, false))
                {
                    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);
        }
    }
}

open System.IO
open System.Text

let fileName = "AppSettings.dat"

let writeDefaultValues () =
    use stream = File.Open(fileName, FileMode.Create)
    use writer = new BinaryWriter(stream, Encoding.UTF8, false)
    writer.Write 1.250F
    writer.Write @"c:\Temp"
    writer.Write 10
    writer.Write true

let displayValues () =
    if File.Exists fileName then
        use stream = File.Open(fileName, FileMode.Open)
        use reader = new BinaryReader(stream, Encoding.UTF8, false)
        let aspectRatio = reader.ReadSingle()
        let tempDirectory = reader.ReadString()
        let autoSaveTime = reader.ReadInt32()
        let showStatusBar = reader.ReadBoolean()

        printfn $"Aspect ratio set to: {aspectRatio}"
        printfn $"Temp directory is: {tempDirectory}"
        printfn $"Auto save time set to: {autoSaveTime}"
        printfn $"Show status bar: {showStatusBar}"

writeDefaultValues ()
displayValues ()

Imports System.IO

Module Module1
    Const fileName As String = "AppSettings.dat"

    Sub Main()
        WriteDefaultValues()
        DisplayValues()
    End Sub

    Sub WriteDefaultValues()
        Using writer As BinaryWriter = New BinaryWriter(File.Open(fileName, FileMode.Create))
            writer.Write(1.25F)
            writer.Write("c:\Temp")
            writer.Write(10)
            writer.Write(True)
        End Using
    End Sub

    Sub DisplayValues()
        Dim aspectRatio As Single
        Dim tempDirectory As String
        Dim autoSaveTime As Integer
        Dim showStatusBar As Boolean

        If (File.Exists(fileName)) Then

            Using reader As BinaryReader = New BinaryReader(File.Open(fileName, FileMode.Open))
                aspectRatio = reader.ReadSingle()
                tempDirectory = reader.ReadString()
                autoSaveTime = reader.ReadInt32()
                showStatusBar = reader.ReadBoolean()
            End Using

            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)
        End If
    End Sub

End Module

Remarks

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

Applies to

.NET 10 och andra versioner

Produkt	Versioner
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

BinaryWriter(Stream, Encoding)

Source:: BinaryWriter.cs

Source:: BinaryWriter.cs

Source:: BinaryWriter.cs

Initializes a new instance of the BinaryWriter class based on the specified stream and character encoding.

public:
 BinaryWriter(System::IO::Stream ^ output, System::Text::Encoding ^ encoding);

public BinaryWriter(System.IO.Stream output, System.Text.Encoding encoding);

new System.IO.BinaryWriter : System.IO.Stream * System.Text.Encoding -> System.IO.BinaryWriter

Public Sub New (output As Stream, encoding As Encoding)

Parameters

output: Stream

The output stream.

encoding: Encoding

The character encoding to use.

Exceptions

ArgumentException

The stream does not support writing or is already closed.

ArgumentNullException

output or encoding is null.

Remarks

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

Applies to

.NET 10 och andra versioner

Produkt	Versioner
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

BinaryWriter(Stream, Encoding, Boolean)

Source:: BinaryWriter.cs

Source:: BinaryWriter.cs

Source:: BinaryWriter.cs

Initializes a new instance of the BinaryWriter class based on the specified stream and character encoding, and optionally leaves the stream open.

public:
 BinaryWriter(System::IO::Stream ^ output, System::Text::Encoding ^ encoding, bool leaveOpen);

public BinaryWriter(System.IO.Stream output, System.Text.Encoding encoding, bool leaveOpen);

new System.IO.BinaryWriter : System.IO.Stream * System.Text.Encoding * bool -> System.IO.BinaryWriter

Public Sub New (output As Stream, encoding As Encoding, leaveOpen As Boolean)

Parameters

output: Stream

The output stream.

encoding: Encoding

The character encoding to use.

leaveOpen: Boolean

true to leave the stream open after the BinaryWriter object is disposed; otherwise, false.

Exceptions

ArgumentException

The stream does not support writing or is already closed.

ArgumentNullException

output or encoding is null.

Applies to

.NET 10 och andra versioner

Produkt	Versioner
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Dela via

BinaryWriter Constructors

Definition

Overloads

BinaryWriter()

Remarks

See also

Applies to

BinaryWriter(Stream)

Parameters

Exceptions

Examples

Remarks

See also

Applies to

BinaryWriter(Stream, Encoding)

Parameters

Exceptions

Remarks

See also

Applies to

BinaryWriter(Stream, Encoding, Boolean)

Parameters

Exceptions

See also

Applies to

Ytterligare resurser