dokumentumok összehasonlítása .net – Teljes GroupDocs.Comparison útmutató .NET fejlesztőknek
If you need to compare documents .net programmatically, you’ve landed on the right guide.
Manually spotting differences between two versions of a contract, a spreadsheet, or a presentation can waste hours and still miss subtle changes. With GroupDocs.Comparison for .NET you can automate this task, generate visual diff reports, and even accept or reject changes without opening the files yourself. This tutorial walks you through every step—from installing the NuGet package to handling large‑scale folder comparisons—so you can embed reliable document comparison into any .NET solution.
Gyors válaszok
- Mi a GroupDocs.Comparison elsődleges célja? Programozott módon dokumentumok összehasonlítása, változások észlelése, valamint vizuális vagy adat‑alapú diff eredmények generálása.
- Elfogadhatok vagy elutasíthatok változásokat automatikusan? Igen—használd az accept/reject API-t a részletes vezérléshez.
- Támogatja a könyvtár a képek összehasonlítását .NET-ben? Természetesen; összehasonlíthatsz képernyőképeket, UI rendereléseket és bármilyen raszteres képet.
- Lehetséges mappák összehasonlítása? Igen—összehasonlíthatod az egész mappákat, hogy megtaláld a hozzáadott, eltávolított vagy módosított fájlokat.
- Mire van szükség a kezdéshez? .NET fejlesztői környezet, a NuGet csomag, és egy érvényes GroupDocs.Comparison licenc (próba elérhető).
Mi a compare documents .net?
compare documents .net is the process of programmatically identifying differences between two or more document versions using a .NET library. GroupDocs.Comparison implements this by loading source and target files, applying configurable comparison options, and returning a ComparisonResult that contains both visual highlights and a structured list of changes. ComparisonResult represents the outcome of a comparison, containing the detected changes and visual diff data.
Miért válasszuk a GroupDocs.Comparison-t .NET-hez?
GroupDocs.Comparison supports over 50 formats, processes large PDFs in seconds, and includes enterprise‑grade features such as password handling, metadata preservation, and fine‑grained change management, eliminating the need for multiple specialized libraries and reducing development effort.
Előfeltételek
- Visual Studio 2022 vagy újabb (vagy bármely .NET‑kompatibilis IDE).
- .NET 6+ runtime (a könyvtár támogatja a .NET Core 3.1-et és a .NET Framework 4.8-at is).
- NuGet csomag
GroupDocs.Comparison(legújabb stabil verzió). - Érvényes licenckulcs (elindíthatod egy 30‑napos próba verzióval).
Hogyan hasonlíthatok össze két dokumentumot .net?
To compare two documents .net, instantiate the Comparer class, call Compare(sourcePath, targetPath, outputPath), and specify any ComparisonOptions you need. The method creates a diff file that highlights insertions, deletions, and formatting changes, while also exposing a Changes collection for programmatic inspection. The Comparer object is the core engine that drives the comparison process.
Lépésről‑lépésre útmutató
- Hozz létre egy
Comparerpéldányt – ez a magobjektum, amely a összehasonlító motor működését vezérli. - Töltsd be a forrást és a célt – megadhatsz fájlútvonalakat, stream-eket vagy byte tömböket; stream-ek ajánlottak 10 MB-nál nagyobb fájlok esetén.
- Állítsd be a beállításokat – figyelmen kívül hagyhatod a kis‑nagybetűket, megadhatsz jelszót, vagy módosíthatod az érzékenységet a
ComparisonOptionssegítségével. - Végrehajtsd az összehasonlítást – hívd meg a
Comparemetódust, és add meg a vizuális diff kimeneti helyét. - Feldolgozd az eredményeket – olvasd a
Changesgyűjteményt, hogy elfogadd, elutasítsd vagy naplózd az egyes módosításokat.
Milyen formátumokat hasonlíthatok össze a GroupDocs.Comparison segítségével?
GroupDocs.Comparison supports 50+ input and output formats, including DOCX, PDF, XLSX, PPTX, PNG, JPEG, BMP, and TIFF. It can also handle password‑protected files and files stored in cloud storage (via stream APIs). This breadth eliminates the need for multiple libraries when building a universal document‑processing pipeline.
Hogyan fogadhatok el vagy utasíthatok el változásokat programozottan?
The ComparisonResult object exposes a Changes collection. Each ChangeInfo item describes a single detected change and provides Accept() and Reject() methods. Call result.Changes.AcceptAll() to apply every detected change to the target document, or iterate result.Changes and invoke Accept() or Reject() on individual ChangeInfo objects for granular control. After applying the desired actions, save the updated document with result.Save(outputPath).
Hogyan hasonlíthatok össze teljes mappákat .net?
Folder comparison involves iterating over matching file pairs and invoking the same Compare logic for each pair. GroupDocs.Comparison also offers a helper method CompareFolders(sourceFolder, targetFolder, outputFolder) that compares all matching files in two directories, detects added or removed files, and generates diff results. CompareFolders returns a collection of FolderComparisonResult objects, each indicating the status of a file pair and a link to its diff document.
Hogyan működik a képek összehasonlítása .NET-ben?
The image module treats each pixel as a data point, generating a diff image that highlights changed regions in red and returning a similarity score (0‑100 %). Call Comparer.CompareImages(imagePath1, imagePath2, outputPath); the engine aligns the images, computes per‑pixel differences, writes a diff image where altered pixels are colored, and provides a Similarity value you can use to trigger alerts or skip further processing if the change is below a threshold.
Gyakori felhasználási esetek
- Verziókezelés nem‑kódbeli eszközök számára – tarts tiszta audit nyomot a szerződésváltozatokról.
- Automatizált megfelelőségi ellenőrzések – jelöld a jogosulatlan módosításokat a szabályzat dokumentumokban.
- CI/CD pipeline-ok UI teszteléshez – hasonlítsd össze a weboldalak képernyőképeit a különböző build-ek között.
- Kötegelt migrációs projektek – ellenőrizd, hogy a konvertált fájlok megtartják-e az eredeti tartalmat.
Teljesítmény tippek nagy dokumentumokhoz
- Stream-eld a fájlokat a teljes memóriába betöltés helyett; ez akár 80 %-kal csökkentheti a csúcs RAM használatot.
- Használd újra ugyanazt a
Comparerpéldányt több összehasonlításhoz, hogy kihasználd a belső gyorsítótárat. - Állítsd be a
ComparisonOptions.MemoryLimit-et 500 MB-nál nagyobb dokumentumok esetén, hogy elkerüld a memóriahiányos kivételeket.
Gyakran Ismételt Kérdések
Q: How do I programmatically accept or reject changes after a comparison?
A: Use result.Changes.AcceptAll(), RejectAll(), or iterate each ChangeInfo and call Accept() / Reject() as needed, then save the document with result.Save(outputPath).
Q: Can I extract metadata such as author, creation date, or custom properties from documents?
A: Yes—DocumentInfo provides access to standard and custom metadata for both source and target files, allowing you to log or display this information.
Q: Is it possible to compare image files (e.g., PNG, JPEG) directly in .NET?
A: Absolutely. The CompareImages API highlights pixel‑level differences and returns a similarity percentage you can use in automated tests.
Q: How can I compare entire folders to find added, removed, or modified files?
A: Invoke Comparer.CompareFolders(sourceFolder, targetFolder, outputFolder); the method returns a collection of FolderComparisonResult objects that indicate the status of each file pair.
Q: What should I do if I need to compare password‑protected documents?
A: Supply the password via LoadOptions.Password when loading each document; the engine decrypts the files internally before performing the diff.
Q: Does GroupDocs.Comparison support .NET Core and .NET 5/6?
A: Yes—the library is compatible with .NET Core 3.1, .NET 5, .NET 6, and later, offering the same feature set across all runtimes.
Bizalom jelek
Last Updated: 2026-05-26
Tested With: GroupDocs.Comparison 23.12 for .NET
Author: GroupDocs
További oktatóanyag linkek (változatlan)
Dokumentumok és mappa összehasonlítása
Dokumentum összehasonlítás
Dokumentumok betöltése és mentése
Kép összehasonlítás
Alapvető használat
Gyors kezdés
Első lépések
Dokumentum betöltése
Alap összehasonlítás
Haladó összehasonlítás
Változáskezelés
Dokumentum információ
Előnézet generálás
Metaadatkezelés
Biztonság és védelem
Licencelés és konfiguráció
Összehasonlítási beállítások
További információ További információ További információ További információ További információ További információ Első lépések Dokumentum betöltése Alap összehasonlítás Haladó összehasonlítás Változáskezelés Dokumentum információ Előnézet generálás Metaadatkezelés Biztonság és védelem Licencelés és konfiguráció Összehasonlítási beállítások Gyors kezdés Első lépések Dokumentumok és mappa összehasonlítása Dokumentum összehasonlítás Dokumentumok betöltése és mentése Kép összehasonlítás Alapvető használat Gyors kezdés Első lépések Dokumentum betöltése Alap összehasonlítás Haladó összehasonlítás Változáskezelés Dokumentum információ Előnézet generálás Metaadatkezelés Biztonság és védelem Licencelés és konfiguráció Összehasonlítási beállítások