IRONSOFTWAREHOME
MISES À JOUR POUR LES DÉVELOPPEURS

FileStream C# (Comment ça fonctionne pour les développeurs)

Jacob Mellor, Directeur technique @ Team Iron
Jacob Mellor
Updated: 23 avril 2026

Cet article se concentrera sur la classe FileStream en C# et comment elle vous aide à effectuer des opérations de lecture et d'écriture sur les fichiers. Nous allons explorer des exemples pratiques, comprendre comment FileStream fonctionne dans son essence, et apprendre à gérer efficacement les données des fichiers. Ce guide est destiné à ceux qui débutent dans la gestion de fichiers en C#, donc le langage restera convivial pour les débutants tout en fournissant des instructions détaillées sur le travail avec les fichiers en C# et une introduction à la bibliothèque IronPDF également.

Qu'est-ce que FileStream ?

La classe FileStream en C# fournit un moyen de gérer les fichiers en utilisant des octets. Elle fonctionne avec des opérations de lecture et d'écriture sur les fichiers, vous permettant d'interagir directement avec le contenu des fichiers. C'est particulièrement utile lorsque vous travaillez avec des fichiers pour des tâches d'entrée/sortie, surtout en manipulant des tableaux d'octets.

Cas d'utilisation de FileStream

FileStream est idéal pour :

  • Lire et écrire des données binaires directement à partir ou vers des fichiers.
  • Gérer efficacement de grands fichiers.
  • Effectuer des opérations de fichiers asynchrones.
  • Gérer les ressources système en utilisant efficacement la mémoire.

Exemple de base

Voici un exemple simple pour ouvrir un fichier, écrire des données, puis les lire en utilisant FileStream :

using System;
using System.IO;

public class Example
{
    public static void Main()
    {
        string path = "example.txt";
        
        // Creating a FileStream object to handle the file. The file handle is acquired here.
        using (FileStream fileStream = new FileStream(path, FileMode.Create, FileAccess.Write))
        {
            byte[] data = System.Text.Encoding.UTF8.GetBytes("Hello, FileStream!");
            // Write data to file
            fileStream.Write(data, 0, data.Length);
        }
        
        // Read from the file
        using (FileStream fileStream = new FileStream(path, FileMode.Open, FileAccess.Read))
        {
            byte[] buffer = new byte[1024];
            int bytesRead = fileStream.Read(buffer, 0, buffer.Length);
            string text = System.Text.Encoding.UTF8.GetString(buffer, 0, bytesRead);
            Console.WriteLine(text);
        }
    }
}

Cet exemple montre la création d'un objet FileStream pour gérer les opérations de lecture et d'écriture de fichiers. La classe FileStream lit et écrit des octets directement, ce qui la rend adaptée à la gestion de grands fichiers ou de données binaires. Nous avons utilisé Encoding pour convertir entre texte et octets.

Écriture de données avec FileStream

Pour écrire des données dans un fichier, vous utiliserez la méthode Write. Voici un exemple qui explique comment cela fonctionne en détail :

using System;
using System.IO;

public class FileWriteExample
{
    public static void Main()
    {
        string path = "output.txt";
        
        // Creating a FileStream object to write data to the file
        using (FileStream fileStream = new FileStream(path, FileMode.Create, FileAccess.Write))
        {
            byte[] buffer = System.Text.Encoding.UTF8.GetBytes("Writing data to FileStream.");
            int offset = 0;
            int count = buffer.Length;
            
            // Writing data to the file
            fileStream.Write(buffer, offset, count);
        }
    }
}

Dans ce code, nous convertissons une chaîne en un tableau d'octets en utilisant le codage UTF8. La méthode Write écrit le tableau d'octets dans le fichier à partir de la position actuelle (déterminée par le décalage) et en écrivant le nombre spécifié d'octets.

  • FileMode.Create crée un nouveau fichier, écrasant tout fichier existant portant le même nom.
  • FileAccess.Write accorde les autorisations d'écriture au FileStream.

Lecture de données avec FileStream

Maintenant, explorons comment lire des données à partir d'un fichier en utilisant FileStream.

using System;
using System.IO;

public class FileReadExample
{
    public static void Main()
    {
        // File path
        string path = "output.txt";

        // File Stream Object
        using (FileStream fileStream = new FileStream(path, FileMode.Open, FileAccess.Read))
        {
            byte[] buffer = new byte[1024];
            int bytesRead = fileStream.Read(buffer, 0, buffer.Length);
            // Output Stream
            string output = System.Text.Encoding.UTF8.GetString(buffer, 0, bytesRead);
            Console.WriteLine(output);
        }
    }
}

Dans cet exemple :

  • FileMode.Open ouvre un fichier existant.
  • La méthode Read lit un nombre spécifié d'octets (en fonction de la taille du tampon) et les stocke dans le tampon tableau d'octets.
  • Nous utilisons Encoding.UTF8.GetString pour reconvertir les données d'octets en une chaîne.

Gestion de l'accès aux fichiers avec FileStream

La classe FileStream contrôle l'accès aux fichiers, permettant une gestion affinée des descripteurs de fichiers et des ressources système. Lors de l'utilisation de FileStream, il est essentiel de s'assurer que le flux est correctement libéré après utilisation, soit en appelant Close() manuellement, soit en utilisant l'instruction using qui libère automatiquement le flux.

Gestion de la position du fichier

Chaque fois que vous lisez ou écrivez dans un fichier, FileStream suit la position actuelle dans le fichier. Vous pouvez accéder à cette position en utilisant la propriété Position :

fileStream.Position = 0; // Move to the beginning of the file

Utilisation de FileStream pour des opérations asynchrones

FileStream peut être utilisé pour des opérations de lecture et d'écriture asynchrones, améliorant les performances en permettant à d'autres processus de s'exécuter pendant que les opérations de fichiers sont effectuées. Voici un exemple basique de lecture asynchrone :

using System;
using System.IO;
using System.Threading.Tasks;

public class AsyncReadExample
{
    public static async Task Main()
    {
        // Specified Path
        string path = "output.txt";
        
        using (FileStream fileStream = new FileStream(path, FileMode.Open, FileAccess.Read, FileShare.None, 4096, true))
        {
            byte[] buffer = new byte[1024];
            int bytesRead = await fileStream.ReadAsync(buffer, 0, buffer.Length);
            string result = System.Text.Encoding.UTF8.GetString(buffer, 0, bytesRead);
            Console.WriteLine(result);
        }
    }
}

La méthode ReadAsync lit les données de manière asynchrone. Les paramètres FileAccess.Read et FileMode.Open contrôlent comment le fichier est accédé.

Exemple de gestion des exceptions

Lorsque vous travaillez avec FileStream, la gestion des exceptions est essentielle pour éviter les erreurs d'exécution et gérer correctement les ressources système. Voici un modèle pour gérer les exceptions lors de la lecture ou de l'écriture dans les fichiers :

using System;
using System.IO;

public class ExceptionHandlingExample
{
    public static void Main()
    {
        string path = "nonexistentfile.txt";
        
        try
        {
            using (FileStream fileStream = new FileStream(path, FileMode.Open, FileAccess.Read))
            {
                byte[] buffer = new byte[1024];
                int bytesRead = fileStream.Read(buffer, 0, buffer.Length);
                Console.WriteLine("Bytes Read: " + bytesRead);
            }
        }
        catch (FileNotFoundException e)
        {
            Console.WriteLine($"Exception: {e.Message}");
        }
    }
}

Mise en mémoire tampon et performances

La classe FileStream inclut un mécanisme de mise en mémoire tampon qui permet des performances plus rapides, surtout lorsque vous travaillez avec de grands fichiers. En utilisant un tampon, les données sont stockées temporairement en mémoire, réduisant le besoin d'accès constant au disque.

using System;
using System.IO;

public class BufferingExample
{
    public static void Main()
    {
        string path = "bufferedfile.txt";
        byte[] data = System.Text.Encoding.UTF8.GetBytes("Buffered FileStream example.");
        
        using (FileStream fileStream = new FileStream(path, FileMode.Create, FileAccess.Write, FileShare.None, 4096, FileOptions.WriteThrough))
        {
            fileStream.Write(data, 0, data.Length);
        }
    }
}

Ici, FileOptions.WriteThrough garantit que les données sont écrites directement dans le fichier, en évitant un tampon supplémentaire. Cependant, vous pouvez contrôler la taille du tampon pour un réglage des performances.

Présentation d'IronPDF

FileStream C# (Comment ça fonctionne pour les développeurs) : Figure 1 - IronPDF : La bibliothèque PDF en C#

IronPDF est une bibliothèque C# PDF robuste pour la création, la modification et la manipulation de documents PDF au sein des applications .NET. Les développeurs peuvent générer des PDF à partir de diverses entrées telles que HTML, des images, et même du texte brut avec IronPDF. Avec des fonctionnalités telles que le filigrane, la fusion, la division et la protection par mot de passe, IronPDF est idéal pour les applications web et de bureau avec un contrôle précis sur la sortie PDF.

IronPDF avec FileStream

Voici un exemple de génération d'un PDF avec IronPDF et en l'enregistrant dans un FileStream. Cela démontre comment IronPDF s'intègre parfaitement avec FileStream, permettant aux développeurs de contrôler de manière programmatique la création et l'enregistrement de PDF.

using System;
using System.IO;
using IronPdf;

public class IronPDFExample
{
    public static void Main()
    {
        // Define the file path
        string path = "output.pdf";
        
        // Create an HTML string that we want to convert to PDF
        var htmlContent = "<h1>IronPDF Example</h1><p>This PDF was generated using IronPDF and saved with FileStream.</p>";
        
        // Initialize IronPDF's ChromePdfRenderer to render HTML as PDF
        var renderer = new ChromePdfRenderer();
        
        // Generate the PDF from the HTML string
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);
        
        // Use FileStream to save the generated PDF
        using (FileStream fileStream = new FileStream(path, FileMode.Create, FileAccess.Write))
        {
            pdfDocument.SaveAs(fileStream);
        }
        
        Console.WriteLine("PDF created and saved successfully.");
    }
}

Conclusion

La classe FileStream en C# offre une fonctionnalité puissante pour la gestion des entrées et sorties de fichiers. Elle permet aux développeurs de lire et écrire des données efficacement, de contrôler la position actuelle dans un fichier, et de travailler de manière asynchrone en comprenant comment les tableaux d'octets, les chemins de fichiers, et la gestion des flux fonctionnent ensemble. L'utilisation de FileStream en combinaison avec IronPDF offre aux développeurs la flexibilité de gérer efficacement les PDFs au sein des applications .NET. Que vous génériez des rapports, enregistrez des fichiers ou gériez du contenu dynamique, cette combinaison offre un contrôle raffiné sur la création et le stockage de documents PDF.

IronPDF propose une essai gratuit et des frais de licence $999, ce qui en fait une solution compétitive pour les besoins professionnels de génération de PDF.

Jacob Mellor, Directeur technique @ Team Iron
Directeur technique

Jacob Mellor est directeur de la technologie chez Iron Software et un ingénieur visionnaire pionnier de la technologie C# PDF. En tant que développeur à l'origine de la base de code centrale d'Iron Software, il a façonné l'architecture des produits de l'entreprise depuis sa création, la transformant aux côtés du PDG Cameron Rimington en une entreprise de plus de 50 personnes au service de la NASA, de Tesla et d'agences gouvernementales mondiales.

...
Lire la suite

Articles connexes

Key in blue circle

Obtenez votre clé d'essai de 30 jours instantanément.

Your trial license will be sent to your email address

Aucune restriction. 100 % débloqué. Pas de carte bancaire.

bullet_checkedAucune carte de crédit ou création de compte requiseAucune restriction. 100 % débloqué. Pas de carte bancaire.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Réservez votre Démonstration en direct gratuite
Booking Badge

De confiance par des millions d'ingénieurs dans le monde entier

Logos des clients d'Iron Software
Obtenez Votre Consultation sans Engagement
Remplissez le formulaire ci-dessous ou envoyez un email à sales@ironsoftware.com
Vos informations seront toujours gardées confidentielles.
De confiance par des millions d'ingénieurs dans le monde entier
Logos des clients d'Iron Software
Obtenez votre clé d'essai 30 jours gratuitement.
Aucune carte de crédit ou création de compte requise