Bearbeiten von Excel-Arbeitsmappen-Metadaten in C#

Welche Eigenschaften kann ich programmatisch ändern?

: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");

Imports IronXL
Imports System

Private workBook As 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
Dim creationDate? As DateTime = workBook.Metadata.Created

' Read the last printed date of the excel file
Dim printDate? As DateTime = workBook.Metadata.LastPrinted

workBook.SaveAs("editedMetadata.xlsx")

Für komplexere Szenarien können Sie die Bearbeitung von Metadaten mit anderen Excel-Vorgängen kombinieren. Hier ist ein umfassendes Beispiel, das die Stapelverarbeitung mehrerer Excel-Dateien demonstriert:

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);
        }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Was geschieht mit den vorhandenen Metadaten, wenn ich speichere?

Wenn Sie Excel-Dateien mit IronXL speichern oder exportieren, behalten alle Metadateneigenschaften, die Sie nicht ausdrücklich geändert haben, ihre ursprünglichen Werte. Nur die von Ihnen geänderten Eigenschaften werden in der gespeicherten Datei aktualisiert. Dieser selektive Aktualisierungsansatz stellt sicher, dass wertvolle bestehende Metadaten bei der Verarbeitung nicht versehentlich verloren gehen. Die folgende Abbildung zeigt, wie die Metadaten nach der Bearbeitung mit IronXL in den Dokumenteigenschaften von Excel erscheinen:

Wenn Sie vorhandene Metadaten löschen müssen, bevor Sie neue Werte festlegen, weisen Sie den Eigenschaften, die Sie zurücksetzen möchten, einfach leere Zeichenfolgen oder Nullwerte zu. Dies ist besonders nützlich, wenn Sie Dokumente für die externe Verteilung vorbereiten, bei denen Sie unternehmensinterne Informationen entfernen möchten.

Welche Eigenschaften unterstützen Lese- und Schreibvorgänge?

Welche Eigenschaften sind schreibgeschützt?

Erweiterte Metadatenoperationen und eine vollständige API-Dokumentation finden Sie in der IronXL API-Referenz. Sollten Sie Probleme mit der Handhabung von Metadaten haben, konsultieren Sie unsere Leitfäden zur Fehlerbehebung oder erkunden Sie die Lizenzierungsoptionen für den Produktionseinsatz.