Comment modifier les métadonnées d'un classeur Excel en C#35;

Quelles sont les propriétés que je peux modifier par programme?

:path=/static-assets/excel/content-code-examples/how-to/edit-workbook-metadata.cs

using IronXL;
using System;

WorkBook workBook = WorkBook.Load("sample.xlsx");

// Set author
workBook.Metadata.Author = "Your Name";
// Set comments
workBook.Metadata.Comments = "Monthly report";
// Set title
workBook.Metadata.Title = "July";
// Set keywords
workBook.Metadata.Keywords = "Report";

// Read the creation date of the excel file
DateTime? creationDate = workBook.Metadata.Created;

// Read the last printed date of the excel file
DateTime? printDate = workBook.Metadata.LastPrinted;

workBook.SaveAs("editedMetadata.xlsx");

Pour des scénarios plus complexes, vous pouvez combiner l'édition de métadonnées avec d'autres opérations Excel. Voici un exemple complet qui démontre le traitement par lots de plusieurs fichiers Excel :

using IronXL;
using System;
using System.IO;

public class BatchMetadataProcessor
{
    public static void ProcessFinancialReports(string folderPath)
    {
        // Get all Excel files in the directory
        string[] excelFiles = Directory.GetFiles(folderPath, "*.xlsx");

        foreach (string filePath in excelFiles)
        {
            // Load the workbook
            WorkBook workBook = WorkBook.Load(filePath);

            // Update metadata based on file content
            string fileName = Path.GetFileNameWithoutExtension(filePath);

            // Set consistent metadata across all reports
            workBook.Metadata.Author = "Finance Department";
            workBook.Metadata.Company = "Your Company Name";
            workBook.Metadata.Category = "Financial Reports";

            // Set dynamic metadata based on filename
            if (fileName.Contains("Q1"))
            {
                workBook.Metadata.Title = "Q1 Financial Report";
                workBook.Metadata.Keywords = "Q1, Finance, Quarterly";
            }
            else if (fileName.Contains("Q2"))
            {
                workBook.Metadata.Title = "Q2 Financial Report";
                workBook.Metadata.Keywords = "Q2, Finance, Quarterly";
            }

            // Add timestamp to comments
            workBook.Metadata.Comments = $"Processed on {DateTime.Now:yyyy-MM-dd HH:mm}";

            // Set the subject based on worksheet content
            WorkSheet sheet = workBook.DefaultWorkSheet;
            workBook.Metadata.Subject = $"Report containing {sheet.RowCount} data rows";

            // Save with updated metadata
            string outputPath = Path.Combine(folderPath, "processed", fileName + "_updated.xlsx");
            workBook.SaveAs(outputPath);
        }
    }
}

using IronXL;
using System;
using System.IO;

public class BatchMetadataProcessor
{
    public static void ProcessFinancialReports(string folderPath)
    {
        // Get all Excel files in the directory
        string[] excelFiles = Directory.GetFiles(folderPath, "*.xlsx");

        foreach (string filePath in excelFiles)
        {
            // Load the workbook
            WorkBook workBook = WorkBook.Load(filePath);

            // Update metadata based on file content
            string fileName = Path.GetFileNameWithoutExtension(filePath);

            // Set consistent metadata across all reports
            workBook.Metadata.Author = "Finance Department";
            workBook.Metadata.Company = "Your Company Name";
            workBook.Metadata.Category = "Financial Reports";

            // Set dynamic metadata based on filename
            if (fileName.Contains("Q1"))
            {
                workBook.Metadata.Title = "Q1 Financial Report";
                workBook.Metadata.Keywords = "Q1, Finance, Quarterly";
            }
            else if (fileName.Contains("Q2"))
            {
                workBook.Metadata.Title = "Q2 Financial Report";
                workBook.Metadata.Keywords = "Q2, Finance, Quarterly";
            }

            // Add timestamp to comments
            workBook.Metadata.Comments = $"Processed on {DateTime.Now:yyyy-MM-dd HH:mm}";

            // Set the subject based on worksheet content
            WorkSheet sheet = workBook.DefaultWorkSheet;
            workBook.Metadata.Subject = $"Report containing {sheet.RowCount} data rows";

            // Save with updated metadata
            string outputPath = Path.Combine(folderPath, "processed", fileName + "_updated.xlsx");
            workBook.SaveAs(outputPath);
        }
    }
}

Qu'advient-il des métadonnées existantes lorsque j'enregistre ?

Lorsque vous enregistrez ou exportez des fichiers Excel à l'aide d'IronXL, toutes les propriétés de métadonnées que vous n'avez pas explicitement modifiées conservent leurs valeurs d'origine. Seules les propriétés que vous avez modifiées seront mises à jour dans le fichier enregistré. Cette approche sélective de la mise à jour permet de s'assurer que les précieuses métadonnées existantes ne sont pas accidentellement perdues au cours du traitement. L'image ci-dessous montre comment les métadonnées apparaissent dans le panneau des propriétés du document d'Excel après avoir été modifiées avec IronXL :

Si vous devez effacer les métadonnées existantes avant de définir de nouvelles valeurs, il vous suffit d'attribuer des chaînes vides ou des valeurs nulles aux propriétés que vous souhaitez réinitialiser. Ceci est particulièrement utile lorsque vous préparez des documents destinés à une distribution externe et que vous souhaitez supprimer les informations internes à l'entreprise.

Quelles sont les propriétés qui prennent en charge les opérations de lecture et d'écriture ?

Quelles sont les propriétés en lecture seule ?

Pour les opérations avancées sur les métadonnées et la documentation complète de l'API, reportez-vous à la Référence de l'API IronXL. Si vous rencontrez des problèmes avec le traitement des métadonnées, consultez nos guides de dépannage ou explorez les options de licence pour les déploiements en production.