BinaryWriter en C#

En C#, BinaryWriter est une classe utilisée pour écrire des types primitifs sous forme de données binaires dans un flux de codage particulier. Il est présent sous l'espace de noms System.IO.

Voici quelques points importants concernant BinaryWriter :

• BinaryWriter est utilisé pour créer des fichiers binaires.
• BinaryWriter peut être utilisé pour écrire des chaînes dans un encodage spécifique.
• Afin de créer un objet de BinaryWriter, nous devons passer un objet de Stream au constructeur de la classe BinaryWriter.
• Lors de la création de l'objet de BinaryWriter, si nous ne spécifions aucun encodage, alors par défaut l'encodage UTF-8 sera utilisé.

Syntaxe avec explication

Le constructeur pour créer un objet de BinaryWriter est disponible sous quatre formes surchargées. La syntaxe pour créer un objet BinaryWriter en utilisant tous ses constructeurs surchargés est la suivante :

Syntaxe n°1

protected BinaryWriter();

Il est utilisé pour initialiser une instance de la classe BinaryWriter.

Syntaxe #2

BinaryWriter binaryWriter = new BinaryWriter(outputStream) ;

L'instruction ci-dessus initialise une nouvelle instance de la classe BinaryWriter sur la base du flux spécifié (outputStream) et en utilisant le codage de caractères UTF-8.

Syntaxe #3

BinaryWriter binaryWriter = new BinaryWriter(outputStream, encoding);

L'instruction ci-dessus initialise une nouvelle instance de BinaryWriter en fonction du flux spécifié (outputStream) et du codage de caractères (encoding).

Syntaxe #4

BinaryWriter binaryWriter = new BinaryWriter(outputStream, encoding, true);

• L'instruction ci-dessus fonctionne de manière similaire aux deuxième et troisième instructions, sauf qu'elle a un paramètre supplémentaire de type de données Boolean que l'on peut utiliser pour indiquer s'il souhaite garder le flux de sortie ouvert après la suppression de l'objet BinaryWriter.
• Pour laisser le flux ouvert, la valeur du paramètre booléen doit être définie sur « vrai », sinon elle doit être définie sur « faux ».
• Nous pouvons créer l'objet de la classe BinaryWriter dans le bloc 'using' afin que la mémoire occupée par l'objet soit libérée automatiquement lorsque le travail de l'objet est terminé et qu'il n'est plus nécessaire.

Code :

using (BinaryWriter binaryWriter = new BinaryWriter(File.Open(fileName, FileMode.Create )) )
{
//user code
}

Ici, la méthode File.Open() renvoie l'objet FileStream qui permet de créer une instance de BinaryWriter.

Comment fonctionne BinaryWriter en C# ?

• En C#, BinaryWriter est utilisé pour écrire des données binaires dans un fichier ou on peut dire qu'il est utilisé pour créer des fichiers binaires. Cela nous aide à écrire des types de données primitifs au format binaire dans un flux. Cela nous aide également à écrire des chaînes dans un codage de caractères particulier.
• Pour travailler avec BinaryWriter, il est nécessaire d'importer l'espace de noms System.IO dans le programme. Ensuite, nous pouvons créer l'objet de la classe BinaryWriter en utilisant l'opérateur 'new' et en contournant un objet Stream au constructeur de BinaryWriter.
• Pour créer une instance de BinaryWriter, nous fournissons généralement un objet Stream à son constructeur en même temps que nous pouvons fournir un paramètre facultatif qui spécifie l'encodage à utiliser lors de l'écriture du fichier. Dans le cas où l'utilisateur ne fournit aucun encodage de caractères, l'encodage UTF-8 sera utilisé par défaut.
• Il existe un autre paramètre facultatif qui peut être transmis au constructeur lors de la création de l'objet de BinaryWriter. Ce paramètre est de type booléen et est utilisé pour spécifier si l'utilisateur souhaite que le flux actuel reste ouvert ou non après la suppression de l'objet BinaryWriter.
• La classe BinaryWriter fournit différentes méthodes Write() pour différents types de données. Ces méthodes sont utilisées pour écrire des données dans le fichier binaire. Comme la méthode Write(Int32) est utilisée pour écrire un entier signé de quatre octets dans le flux actuel et avance également la position du flux de quatre octets.

Méthodes de BinaryWriter

Le tableau suivant montre les détails de certaines méthodes Write() de BinaryWriter pour différents types de données :

Method	Description
Write(Boolean)	This method is used to write the one-byte Boolean value to the present stream; 0 represents false while 1 represents true.
Write(Byte)	This method is used to write an unsigned byte to the present stream and then it advances the position of the stream by one byte.
Write(Char)	This method is used to write Unicode character to present stream and also it advances the present stream position according to the character encoding used and according to the characters being written to the present stream.
Write(Decimal)	This method is used to write a decimal value to the present stream and also it advances the position of the current stream by sixteen bytes.
Write(Double)	This method is used to write an eight-byte floating-point value to the present stream and then it also advances the position of the current stream by eight bytes.
Write(Int32)	This method is used to write a four-byte signed integer to the present stream and then it advances the position of current stream by four bytes.
Write(String)	This method is used to write length prefixed string to present stream in the present encoding of BinaryWriter and also it advances the current stream position according to the encoding used and according to the characters being written to the present stream.

Examples to Implement BinaryWriter in C#

Example showing the creation of file:

Code:

using System;
using System.IO;
namespace ConsoleApp4
{
public class Demo
{
string fileLocation = "E:\\Content\\newBinaryFile.dat";
public void WritingFile()
{
try
{
//checking if file exists
if (File.Exists(fileLocation))
{
File.Delete(fileLocation);
}
FileStream fileStream = new FileStream(fileLocation, FileMode.Create,
FileAccess.Write, FileShare.ReadWrite);
//creating binary file using BinaryWriter
using (BinaryWriter binaryWriter = new BinaryWriter(fileStream))
{
//writing data using different Write() methods
//of BinaryWriter
binaryWriter.Write(5253);
binaryWriter.Write("This is a string value.");
binaryWriter.Write('A');
}
}
catch (Exception exception)
{
Console.WriteLine(exception.Message);
}
}
public void ReadingFile()
{
try
{
FileStream fileStream = new FileStream(fileLocation, FileMode.Open,
FileAccess.Read, FileShare.ReadWrite);
using (BinaryReader binaryReader = new BinaryReader(fileStream))
{
Console.WriteLine("IntegerValue = " + binaryReader.ReadInt32());
Console.WriteLine("StringValue = " + binaryReader.ReadString());
Console.WriteLine("CharValue = " + binaryReader.ReadChar());
}
}
catch (Exception exception)
{
Console.WriteLine(exception.Message);
}
}
}
public class BinaryWriterDemo
{
static void Main(string[] args)
{
Demo demoObj = new Demo();
demoObj.WritingFile();
demoObj.ReadingFile();
Console.ReadLine();
}
}
}

Output:

Conclusion

In C#, the BinaryWriter class is used to write primitive types as binary information to the stream. If the encoding is not defined, then the BinaryWriter class uses the default UTF-8 character encoding to write data to a binary file. An object of BinaryWriter can be created using the Stream object.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!