Wie man Metadaten aus .NET-Vergleichsergebnissen extrahiert – Vollständige Anleitung

Wenn Sie mit Dokumentvergleichen in .NET-Anwendungen arbeiten, fragen Sie sich vielleicht wie man Metadaten aus den Vergleichsergebnissen extrahiert. Metadaten wie Dateityp, Seitenzahl und Dokumentgröße können für Prüfpfade, Leistungsoptimierung oder einfach zur Anzeige nützlicher Informationen für Endbenutzer entscheidend sein. Dieses Tutorial führt Sie Schritt für Schritt durch das effiziente Abrufen dieser Daten mit GroupDocs.Comparison für .NET.

Schnelle Antworten

  • Was ist die Hauptklasse für den Vergleich? Comparer lädt das Quelldokument und führt die Vergleichsengine aus.
  • Welche Methode gibt Metadaten zurück? GetDocumentInfo() auf einem Zieldokument gibt ein IDocumentInfo-Objekt zurück.
  • Kann ich die Dokumentgröße in .NET erhalten? Ja – die Size-Eigenschaft von IDocumentInfo gibt die Größe in Bytes zurück.
  • Benötige ich eine Lizenz für die Metadatenextraktion? Eine gültige GroupDocs.Comparison-Lizenz ist für den Produktionseinsatz erforderlich; die kostenlose Testversion unterstützt alle Metadatenfunktionen.
  • Ist die API mit .NET 6 kompatibel? Absolut – GroupDocs.Comparison unterstützt .NET Framework 4.6.1+, .NET Core 2.0+ und .NET 5/6+.

Die Methode GetDocumentInfo() gibt ein IDocumentInfo-Objekt zurück, das Dokumentmetadaten enthält.

Was ist Metadatenextraktion beim Dokumentvergleich?

Metadatenextraktion ist der Prozess des Abrufens beschreibender Informationen – wie Dateityp, Seitenzahl und Dateigröße – aus den Dokumenten, die an einem Vergleichsvorgang beteiligt sind. GroupDocs.Comparison stellt diese Daten über eine einheitliche API bereit, wodurch das Protokollieren, Anzeigen oder die bedingte Verarbeitung erleichtert wird.

Warum Metadaten aus Vergleichsergebnissen extrahieren?

Durch das Extrahieren von Metadaten können Sie detaillierte Prüfprotokolle erstellen, Dateien basierend auf ihrem Typ weiterleiten und Verarbeitungsstrategien für große Dokumente anpassen. Wenn Sie den Dateityp, die Seitenzahl und die Größe kennen, können Sie Compliance‑Regeln durchsetzen, die Verarbeitungszeit abschätzen und den Benutzern klare Informationen präsentieren, bevor sie einen Vergleich starten.

Voraussetzungen

  1. GroupDocs.Comparison für .NET – Installieren Sie die Bibliothek von der offiziellen Release‑Seite.
    Sie können alle Releases auch auf der GroupDocs Release‑Seite durchsuchen.
  2. Entwicklungsumgebung – Visual Studio, VS Code oder jede IDE, die .NET 6+ unterstützt.
  3. Beispieldokumente – Zwei Dateien (z. B. SOURCE.docx und TARGET.docx) zum Testen. Die API funktioniert mit über 50 Dokumentformaten.

Namespaces importieren

Die folgenden using‑Direktiven geben Ihnen Zugriff auf die Kernvergleichs‑Engine, Dateiverwaltungs‑Utilities und die Metadaten‑Schnittstellen.

using System;
using System.IO;
using System.Linq;
using GroupDocs.Comparison;
using GroupDocs.Comparison.Interfaces;

Diese Importe sind erforderlich, bevor Sie irgendwelche GroupDocs‑Objekte instanziieren.

Wie extrahiert man Metadaten aus Vergleichsergebnissen?

Die Klasse Comparer lädt das Quelldokument und steuert den Vergleichsprozess.

Um Metadaten abzurufen, laden Sie zunächst das Quelldokument mit einer Comparer‑Instanz, dann fügen Sie das/die Zieldokument(e) hinzu. Nachdem die Vergleichs‑Engine initialisiert ist, rufen Sie GetDocumentInfo() für jedes Ziel auf, um ein IDocumentInfo‑Objekt zu erhalten, das Eigenschaften wie Dateityp, Seitenzahl und Größe enthält. Dieser Ansatz funktioniert einheitlich für alle unterstützten Formate.

Schritt 1: Comparer mit Quelldokument initialisieren

Comparer ist die Kernklasse in GroupDocs.Comparison, die das Quelldokument lädt und Vergleichsvorgänge steuert. Die Verwendung eines using‑Blocks stellt sicher, dass alle nicht verwalteten Ressourcen automatisch freigegeben werden.

using (Comparer comparer = new Comparer(File.OpenRead("SOURCE.docx")))
{

Pro‑Tipp: Sie können jedem Stream (Datei, Speicher, Cloud) an den Comparer‑Konstruktor übergeben, nicht nur einen Dateipfad.

Schritt 2: Ziel‑Dokument für den Vergleich hinzufügen

Die Methode Add() akzeptiert zusätzliche Streams oder Dateipfade und ermöglicht One‑to‑Many‑Vergleiche.

comparer.Add(File.OpenRead("TARGET.docx"));

Wichtig: Die Reihenfolge der hinzugefügten Dokumente beeinflusst, wie Änderungen im Abschlussbericht hervorgehoben werden.

Schritt 3: Dokumentinformationen aus dem Ergebnisdokument abrufen

IDocumentInfo bietet eine einheitliche Ansicht von Dokumentmetadaten wie Dateityp, Seitenzahl und Größe über alle unterstützten Formate hinweg.

IDocumentInfo info = comparer.Targets.FirstOrDefault().GetDocumentInfo();

Verständnis der Daten: Das zurückgegebene Objekt funktioniert gleich für DOCX, PDF, XLSX und PPTX, sodass Sie formatunabhängigen Code schreiben können.

Schritt 4: Dokumentinformationen anzeigen

Sobald Sie die IDocumentInfo‑Instanz haben, können Sie deren Eigenschaften protokollieren, speichern oder darstellen.

Console.WriteLine("\nFile type: {0}\nNumber of pages: {1}\nDocument size: {2} bytes", info.FileType, info.PageCount, info.Size);

Die drei am häufigsten verwendeten Eigenschaften sind:

  • FileType – z. B. DOCX, PDF, XLSX.
  • PageCount – Gesamtseiten oder Folien.
  • Size – Dateigröße in Bytes (nützlich für Speicherberechnungen).

Wie erhält man die Dokumentgröße in .NET?

Die Eigenschaft Size gibt die Dateigröße in Bytes zurück.

Die Dokumentgröße kann direkt über die Size‑Eigenschaft der IDocumentInfo‑Instanz abgerufen werden. Diese Eigenschaft gibt die genaue Anzahl der Bytes der Originaldatei zurück, sodass Sie sie für die Anzeige oder Speicherberechnungen in Kilobyte oder Megabyte umrechnen können. Sie spiegelt die Größe der Quelldatei wider, nicht einer verarbeiteten Version.

long sizeInBytes = documentInfo.Size;
double sizeInMegabytes = sizeInBytes / (1024.0 * 1024.0);
Console.WriteLine($"Document size: {sizeInMegabytes:F2} MB");

Hinweis: Der Size‑Wert spiegelt die Originaldateigröße wider, nicht die Größe nach interner Verarbeitung oder Kompression.

Häufige Anwendungsfälle und praktische Anwendungen

  • Batch‑Verarbeitung: Verwenden Sie den Dateityp, um DOCX‑Dateien zu einem Word‑spezifischen Workflow und PDFs zu einer PDF‑optimierten Pipeline zu leiten.
  • Speicherverwaltung: Archivieren Sie Dokumente größer als 10 MB automatisch in einem Cold‑Storage‑Bucket.
  • Benutzer‑Feedback: Zeigen Sie Seitenzahl und Größe vor dem Vergleich an, um realistische Erwartungen an die Verarbeitungszeit zu setzen.
  • Qualitätssicherung: Verifizieren Sie, dass hochgeladene Dateien vollständig sind, indem Sie erwartete und tatsächliche Seitenzahlen vergleichen.

Fehlersuche bei häufigen Problemen

  • Dateizugriffsfehler: Überprüfen Sie Lese­berechtigungen und verwenden Sie absolute Pfade während der Entwicklung.
  • Speicherbelastung bei großen Dateien: Bevorzugen Sie Streaming (File.OpenRead) statt das gesamte Dokument in den Speicher zu laden.
  • Null‑Referenz‑Ausnahmen: FirstOrDefault() kann null zurückgeben, wenn kein Ziel hinzugefügt wurde; prüfen Sie immer, bevor Sie GetDocumentInfo() aufrufen.
var target = comparer.Targets.FirstOrDefault();
if (target != null)
{
    var info = target.GetDocumentInfo();
    // Use info safely
}
else
{
    Console.WriteLine("No target document was added.");
}
  • Begrenzte Metadaten für Klartext: Formate wie .txt stellen möglicherweise keinen sinnvollen PageCount bereit. Schützen Sie sich vor fehlenden Werten.

Leistungsüberlegungen

  • Stream‑Verwaltung: Packen Sie Streams immer in using‑Anweisungen, um Dateihandles zeitnah freizugeben.
  • Caching: Speichern Sie häufig abgerufene Metadaten in einem Cache, um wiederholte Extraktionen zu vermeiden.
  • Batch‑Operationen: Verarbeiten Sie Dokumente in Gruppen, um Overhead zu reduzieren und den Durchsatz zu erhöhen.

Best Practices für den Produktionseinsatz

  • Robuste Fehlerbehandlung: Umschließen Sie die Metadatenextraktion mit try‑catch‑Blöcken, um beschädigte oder nicht unterstützte Dateien elegant zu behandeln.
  • Umfassendes Logging: Protokollieren Sie Dokumenttyp, Größe und Seitenzahl für jeden Vergleich, um Fehlersuche und Prüfkonformität zu unterstützen.
  • Sicherheits‑Hygiene: Vermeiden Sie die Offenlegung vollständiger Dateipfade oder interner Serverdetails in UI‑Nachrichten.
  • Ressourcen‑Freigabe: Entsorgen Sie Comparer‑Instanzen umgehend, insbesondere in Web‑Services, die viele gleichzeitige Anfragen bearbeiten.

Erweiterte Szenarien

Mehrere Ziel‑Dokumente

Wenn Sie ein Quell‑Dokument mit mehreren Ziel‑Dokumenten vergleichen, iterieren Sie durch die Targets‑Sammlung und extrahieren Sie die Metadaten jedes Dokuments.

foreach (var target in comparer.Targets)
{
    IDocumentInfo info = target.GetDocumentInfo();
    // Process each target's information
}

Bedingte Verarbeitung basierend auf Metadaten

if (info.Size > 5 * 1024 * 1024) // larger than 5 MB
{
    // Apply a different comparison setting or queue for background processing
}

Metadaten in einer Datenbank speichern

Speichern Sie FileType, PageCount und Size in einer relationalen Tabelle, um Berichte und Analysen über tausende Vergleiche hinweg zu ermöglichen.

Häufig gestellte Fragen

Q: Ist GroupDocs.Comparison für .NET mit verschiedenen Dokumentformaten kompatibel?
A: Ja, es unterstützt über 50 Formate einschließlich DOCX, PDF, PPTX, XLSX, TXT und vielen anderen und bietet konsistente Metadatenextraktion über alle hinweg.

Q: Kann ich Vergleichseinstellungen anpassen, ohne die Metadatenextraktion zu beeinflussen?
A: Absolut. Einstellungen wie Empfindlichkeit, Änderungstypen und Ausgabeformat sind unabhängig vom Aufruf GetDocumentInfo().

Q: Gibt es eine Testversion, die ich für die Evaluierung nutzen kann?
A: Ja, laden Sie eine kostenlose Testversion von der GroupDocs Release‑Seite herunter. Die Testversion enthält die vollständigen Metadatenextraktions‑Funktionen.

Q: Wo kann ich Unterstützung für Implementierungsfragen erhalten?
A: Nutzen Sie das GroupDocs.Comparison‑Forum für Community‑Hilfe und offiziellen Support vom GroupDocs‑Team.

Q: Welche Lizenzoptionen stehen für Produktions‑Deployments zur Verfügung?
A: GroupDocs bietet Entwickler‑, Site‑ und OEM‑Lizenzen an. Kaufoptionen sind auf der GroupDocs Kauf‑Seite aufgeführt.

Zuletzt aktualisiert: 2026-06-15
Getestet mit: GroupDocs.Comparison 6.0 für .NET
Autor: GroupDocs

var targetDoc = comparer.Targets.FirstOrDefault();
if (targetDoc != null)
{
    IDocumentInfo info = targetDoc.GetDocumentInfo();
    // Process document info
}

Verwandte Tutorials