Comment exporter vers CSV dans Blazor

Configurer votre projet Blazor

Pour commencer, vous devez créer un nouveau projet Blazor Server. Ouvrez Visual Studio, créez un nouveau projet et sélectionnez le modèle "Blazor Server App". Nommez votre projet et cliquez sur "Crée".

Une fois votre projet créé, ouvrez le dossier Pages et localisez le fichier Index.razor. C'est là où les composants Blazor sont ajoutés et codés pour gérer les téléchargements et les conversions de fichiers.

Installer IronXL

Avant de commencer à écrire du code, il est nécessaire d'installer la bibliothèque IronXL. Ouvrez la Console du Gestionnaire de Packages dans Visual Studio et exécutez la commande suivante :

Install-Package IronXL.Excel

Cette commande installera la bibliothèque IronXL dans votre projet Blazor. Vous êtes maintenant prêt à commencer à écrire du code !

Créer le composant de téléchargement de fichier

Tout d'abord, créez un composant de téléchargement de fichier de base qui permet aux utilisateurs de télécharger un fichier Excel existant. Ensuite, le composant InputFile est ajouté à partir de l'espace de noms Microsoft.AspNetCore.Components.Forms. Ajoutez le code suivant à votre fichier Index.razor, sous la ligne "@page "" :

@using Microsoft.AspNetCore.Components.Forms
@using IronXL
@using System.IO
@using System.Threading.Tasks

<div class="container">
    <h3>File Upload</h3>

    <InputFile class="button" OnChange="@OnInputFileChange" accept=".xls,.xlsx,.xlsm,.xltx,.csv,.tsv" />
    <h3>Selected File: @originalFileName</h3>
    <h3 style="color:bisque">Is File converted: <span>@message</span></h3>
</div>

Ce code configure le composant de téléchargement de fichiers, complet avec un bouton et une zone de message pour afficher le statut de la conversion du fichier. L'attribut accept sur le composant InputFile spécifie les formats de fichier acceptés.

Écrire le code de conversion de fichier

Maintenant, écrivons le code qui gère le téléchargement et la conversion de fichiers. Une combinaison d'IronXL, Blazor et C# sera utilisée pour accomplir cette tâche. Vous pouvez utiliser IronXL pour convertir un CSV en fichier Excel.

Ajoutez le code suivant à votre fichier Index.razor, sous l'élément div que vous avez ajouté précédemment.

@code {
    private string originalFileName;
    private string message = "";

    private async Task OnInputFileChange(InputFileChangeEventArgs e)
    {
        var file = e.File;
        originalFileName = file.Name;

        try
        {
            // Read the uploaded file into a memory stream
            using var memoryStream = new MemoryStream();
            await file.OpenReadStream().CopyToAsync(memoryStream);

            // Load the workbook using IronXL
            WorkBook workBook = WorkBook.Load(memoryStream);

            // Save the workbook as a CSV file
            string outputPath = "sample.csv";
            workBook.SaveAsCsv(outputPath);

            message = "Conversion completed!";
        }
        catch (Exception ex)
        {
            message = $"An error occurred: {ex.Message}";
        }
    }
}

Ce code définit une méthode privée appelée OnInputFileChange, qui sera déclenchée lorsqu'une feuille de calcul Excel est téléchargée à l'aide du composant InputFile; Excel peut être au format XLS ou XLSX. Le code lit le fichier Excel basique téléchargé, le charge dans un objet WorkBook, puis enregistre le WorkBook sous forme de fichier CSV. Le statut de la conversion est affiché dans la zone de message sur la page.

Décomposition du code

Tout d'abord, regardez le code complet :

@page "/"
@using Microsoft.AspNetCore.Components.Forms
@using IronXL
@using System.IO
@using System.Threading.Tasks

<style>
    body{
        background-color: skyblue
    }
    .container {
        max-width: 800px;
        margin: 0 auto;
        font-family: Arial, sans-serif;
    }

    h3 {
        margin-top: 30px;
        font-size: 30px;
        margin-bottom: 30px;
    }

    .button {
        background-color: #4CAF50;
        border: none;
        color: white;
        padding: 15px 32px;
        text-align: center;
        text-decoration: none;
        display: inline-block;
        font-size: 16px;
        margin: 15px 0;
        cursor: pointer;
    }
    span {
        font-size: 20px;
    }
</style>

<div class="container">
    <h3>File Upload</h3>

    <InputFile class="button" OnChange="@OnInputFileChange" accept=".xls,.xlsx,.xlsm,.xltx,.csv,.tsv" />
    <h3>Selected File: @originalFileName</h3>
    <h3 style="color:bisque">Is File converted: <span>@message</span></h3>
</div>

@code {
    private string originalFileName;
    private string message = "";

    private async Task OnInputFileChange(InputFileChangeEventArgs e)
    {
        var file = e.File;
        originalFileName = file.Name;

        try
        {
            // Read the uploaded file into a memory stream
            using var memoryStream = new MemoryStream();
            await file.OpenReadStream().CopyToAsync(memoryStream);

            // Load the workbook using IronXL
            WorkBook workBook = WorkBook.Load(memoryStream);

            // Save the workbook as a CSV file
            string outputPath = "sample.csv";
            workBook.SaveAsCsv(outputPath);

            message = "Conversion completed!";
        }
        catch (Exception ex)
        {
            message = $"An error occurred: {ex.Message}";
        }
    }
}

Analysons plus en détail le code :

1. Lorsqu'un fichier est téléchargé, la méthode OnInputFileChange est déclenchée, et un objet InputFileChangeEventArgs lui est passé. Cet objet contient des informations sur le fichier téléchargé, telles que son nom et sa taille.
2. Stockez le nom du fichier original dans une variable appelée originalFileName pour l'afficher sur la page.
3. Dans un bloc try-catch, créez un nouvel objet MemoryStream pour lire le contenu du fichier téléchargé. L'instruction using garantit que le flux de mémoire est correctement éliminé une fois qu'il n'est plus nécessaire.
4. Utilisez le mot-clé await pour copier de manière asynchrone le contenu du fichier téléchargé dans le flux de mémoire. Cela garantit que cette application reste réactive pendant la lecture du fichier.
5. Ensuite, la méthode WorkBook.Load est utilisée pour charger le contenu du flux de mémoire dans un objet WorkBook. Cet objet représente l'ensemble du classeur Excel, y compris ses feuilles, ses cellules et ses données.
6. Ensuite, spécifiez un nom de fichier de sortie pour le fichier CSV converti. Dans ce cas, nous utilisons le nom "sample.csv".
7. La méthode SaveAsCsv de l'objet WorkBook est ensuite utilisée pour enregistrer le classeur sous la forme d'un fichier CSV avec le nom de fichier de sortie spécifié.
8. Si la conversion réussit, un message est affiché pour indiquer que la conversion a été effectuée. En cas d'erreur, capturez l'exception et affichez un message d'erreur.

Tester l'application

Maintenant que l'application Blazor est complète, il est temps de la tester ! Appuyez sur F5 pour exécuter votre application dans Visual Studio. Une fois l'application lancée, vous devriez voir un bouton de téléchargement de fichier sur la page.

Exécuter l'application Blazor

Cliquez sur le bouton et sélectionnez un fichier Excel à télécharger. Les formats de fichiers acceptés sont listés dans l'attribut accept du composant InputFile.

Sélectionner un fichier Excel

Après avoir sélectionné un fichier, l'application lira le fichier, le convertira en format CSV à l'aide d'IronXL et enregistrera le fichier converti avec le nom de fichier de sortie spécifié. Vous devriez voir un message indiquant le statut de la conversion, ainsi que le nom du fichier original.

Statut de la conversion

Félicitations ! Vous avez réussi à construire une application Blazor qui peut exporter des fichiers Excel en format CSV à l'aide d'IronXL. La capture d'écran suivante montre le résultat du programme ci-dessus.

Le fichier Excel de sortie