"How do I programmatically accept or reject changes after a comparison?"

"Use `result.Changes.AcceptAll()`, `RejectAll()`, or iterate each `ChangeInfo` and call `Accept()` / `Reject()` as needed, then save the document with `result.Save(outputPath)`."

"Can I extract metadata such as author, creation date, or custom properties from documents?"

"Yes—`DocumentInfo` provides access to standard and custom metadata for both source and target files, allowing you to log or display this information."

"Is it possible to compare image files (e.g., PNG, JPEG) directly in .NET?"

"Absolutely. The `CompareImages` API highlights pixel‑level differences and returns a similarity percentage you can use in automated tests."

"How can I compare entire folders to find added, removed, or modified files?"

"Invoke `Comparer.CompareFolders(sourceFolder, targetFolder, outputFolder)`; the method returns a collection of `FolderComparisonResult` objects that indicate the status of each file pair."

"What should I do if I need to compare password‑protected documents?"

"Supply the password via `LoadOptions.Password` when loading each document; the engine decrypts the files internally before performing the diff."

porównywanie dokumentów .net – Kompletny samouczek GroupDocs.Comparison dla programistów .NET

Jeśli potrzebujesz compare documents .net programowo, trafiłeś na właściwy przewodnik.
Ręczne wykrywanie różnic między dwiema wersjami umowy, arkusza kalkulacyjnego lub prezentacji może pochłonąć godziny i nadal przegapić subtelne zmiany. Dzięki GroupDocs.Comparison dla .NET możesz zautomatyzować to zadanie, generować wizualne raporty różnic oraz nawet akceptować lub odrzucać zmiany bez otwierania plików. Ten samouczek przeprowadzi Cię przez każdy krok — od instalacji pakietu NuGet po obsługę porównań folderów na dużą skalę — abyś mógł wbudować niezawodne porównywanie dokumentów w dowolnym rozwiązaniu .NET.

Szybkie odpowiedzi

Jaki jest główny cel GroupDocs.Comparison? Aby programowo porównywać dokumenty, wykrywać zmiany i generować wizualne lub oparte na danych wyniki różnic.
Czy mogę automatycznie akceptować lub odrzucać zmiany? Tak — użyj API akceptacji/odrzucania, aby zastosować szczegółową kontrolę.
Czy biblioteka obsługuje porównywanie obrazów w .NET? Zdecydowanie; możesz porównywać zrzuty ekranu, renderingi UI i dowolne obrazy rastrowe.
Czy porównywanie folderów jest możliwe? Tak — porównaj całe foldery, aby wykryć dodane, usunięte lub zmodyfikowane pliki.
Czego potrzebuję przed rozpoczęciem? Środowisko programistyczne .NET, pakiet NuGet oraz ważna licencja GroupDocs.Comparison (dostępna wersja próbna).

Czym jest compare documents .net?

compare documents .net to proces programowego identyfikowania różnic między dwiema lub więcej wersjami dokumentów przy użyciu biblioteki .NET. GroupDocs.Comparison realizuje to poprzez wczytywanie plików źródłowego i docelowego, stosowanie konfigurowalnych opcji porównania oraz zwracanie obiektu ComparisonResult, który zawiera zarówno wizualne podświetlenia, jak i ustrukturyzowaną listę zmian. ComparisonResult reprezentuje wynik porównania, zawierający wykryte zmiany i dane wizualne różnic.

Dlaczego wybrać GroupDocs.Comparison dla .NET?

GroupDocs.Comparison obsługuje ponad 50 formatów, przetwarza duże pliki PDF w ciągu kilku sekund i zawiera funkcje klasy korporacyjnej, takie jak obsługa haseł, zachowanie metadanych oraz precyzyjne zarządzanie zmianami, eliminując potrzebę wielu wyspecjalizowanych bibliotek i redukując nakład pracy programistycznej.

Wymagania wstępne

Visual Studio 2022 lub nowszy (lub dowolne IDE kompatybilne z .NET).
Środowisko uruchomieniowe .NET 6+ (biblioteka obsługuje także .NET Core 3.1 i .NET Framework 4.8).
Pakiet NuGet GroupDocs.Comparison (najnowsza stabilna wersja).
Ważny klucz licencyjny (możesz rozpocząć od 30‑dniowej wersji próbnej).

Jak porównać dwa dokumenty .net?

Aby porównać dwa dokumenty .net, utwórz instancję klasy Comparer, wywołaj Compare(sourcePath, targetPath, outputPath) i określ dowolne potrzebne ComparisonOptions. Metoda tworzy plik różnicowy, który podświetla wstawienia, usunięcia i zmiany formatowania, a także udostępnia kolekcję Changes do programowej inspekcji. Obiekt Comparer jest rdzeniem silnika napędzającego proces porównania.

Przewodnik krok po kroku

Utwórz instancję Comparer – jest to podstawowy obiekt napędzający silnik porównania.
Wczytaj źródło i cel – możesz przekazać ścieżki plików, strumienie lub tablice bajtów; strumienie są zalecane dla plików większych niż 10 MB.
Skonfiguruj opcje – ignoruj wielkość liter, ustaw hasło lub dostosuj czułość za pomocą ComparisonOptions.
Wykonaj porównanie – wywołaj Compare i podaj miejsce docelowe dla wizualnego diffu.
Przetwórz wyniki – odczytaj kolekcję Changes, aby akceptować, odrzucać lub rejestrować każdą modyfikację.

Jakie formaty mogę porównać przy użyciu GroupDocs.Comparison?

GroupDocs.Comparison obsługuje ponad 50 formatów wejściowych i wyjściowych, w tym DOCX, PDF, XLSX, PPTX, PNG, JPEG, BMP i TIFF. Może także obsługiwać pliki chronione hasłem oraz pliki przechowywane w chmurze (poprzez API strumieniowe). Ta szerokość eliminuje potrzebę wielu bibliotek przy budowie uniwersalnego potoku przetwarzania dokumentów.

Jak programowo akceptować lub odrzucać zmiany?

Obiekt ComparisonResult udostępnia kolekcję Changes. Każdy element ChangeInfo opisuje pojedynczą wykrytą zmianę i zapewnia metody Accept() i Reject(). Wywołaj result.Changes.AcceptAll(), aby zastosować wszystkie wykryte zmiany w dokumencie docelowym, lub iteruj result.Changes i wywołuj Accept() lub Reject() na poszczególnych obiektach ChangeInfo w celu precyzyjnej kontroli. Po zastosowaniu żądanych działań, zapisz zaktualizowany dokument za pomocą result.Save(outputPath).

Jak porównać całe foldery .net?

Porównywanie folderów polega na iteracji dopasowanych par plików i wywoływaniu tej samej logiki Compare dla każdej pary. GroupDocs.Comparison oferuje również metodę pomocniczą CompareFolders(sourceFolder, targetFolder, outputFolder), która porównuje wszystkie pasujące pliki w dwóch katalogach, wykrywa dodane lub usunięte pliki i generuje wyniki różnic. CompareFolders zwraca kolekcję obiektów FolderComparisonResult, z których każdy wskazuje status pary plików oraz link do dokumentu diff.

Jak działa porównywanie obrazów w .NET?

Moduł obrazu traktuje każdy piksel jako punkt danych, generując obraz diff, który podświetla zmienione obszary na czerwono i zwracając wynik podobieństwa (0‑100 %). Wywołaj Comparer.CompareImages(imagePath1, imagePath2, outputPath); silnik wyrównuje obrazy, oblicza różnice piksel po pikselu, zapisuje obraz diff, w którym zmienione piksele są pokolorowane, i dostarcza wartość Similarity, którą możesz użyć do wyzwalania alertów lub pomijania dalszego przetwarzania, jeśli zmiana jest poniżej progu.

Typowe przypadki użycia

Kontrola wersji dla zasobów nie‑kodowych – utrzymuj przejrzysty ślad audytu zmian umów.
Automatyczne kontrole zgodności – oznaczaj nieautoryzowane edycje w dokumentach polityki.
Potoki CI/CD do testowania UI – porównuj zrzuty ekranu stron internetowych pomiędzy buildami.
Projekty migracji wsadowej – weryfikuj, że skonwertowane pliki zachowują oryginalną zawartość.

Wskazówki wydajności dla dużych dokumentów

Strumieniuj pliki zamiast ładować je w całości do pamięci; zmniejsza to szczytowe zużycie RAM nawet o 80 %.
Ponownie używaj jednej instancji Comparer dla wielu porównań, aby skorzystać z wewnętrznego buforowania.
Dostosuj ComparisonOptions.MemoryLimit przy pracy z dokumentami większymi niż 500 MB, aby zapobiec wyjątkom braku pamięci.

Najczęściej zadawane pytania

Q: Jak programowo akceptować lub odrzucać zmiany po porównaniu?
A: Użyj result.Changes.AcceptAll(), RejectAll(), lub iteruj każdy ChangeInfo i wywołaj Accept() / Reject() w razie potrzeby, a następnie zapisz dokument za pomocą result.Save(outputPath).

Q: Czy mogę wyodrębnić metadane takie jak autor, data utworzenia lub własne właściwości z dokumentów?
A: Tak — DocumentInfo zapewnia dostęp do standardowych i własnych metadanych zarówno dla plików źródłowych, jak i docelowych, umożliwiając ich logowanie lub wyświetlanie.

Q: Czy można bezpośrednio porównywać pliki obrazów (np. PNG, JPEG) w .NET?
A: Absolutnie. API CompareImages podświetla różnice na poziomie pikseli i zwraca procent podobieństwa, który możesz wykorzystać w testach automatycznych.

Q: Jak mogę porównać całe foldery, aby znaleźć dodane, usunięte lub zmodyfikowane pliki?
A: Wywołaj Comparer.CompareFolders(sourceFolder, targetFolder, outputFolder); metoda zwraca kolekcję obiektów FolderComparisonResult, które wskazują status każdej pary plików.

Q: Co zrobić, jeśli muszę porównać dokumenty chronione hasłem?
A: Podaj hasło poprzez LoadOptions.Password przy wczytywaniu każdego dokumentu; silnik odszyfrowuje pliki wewnętrznie przed wykonaniem diffu.

Q: Czy GroupDocs.Comparison obsługuje .NET Core i .NET 5/6?
A: Tak — biblioteka jest kompatybilna z .NET Core 3.1, .NET 5, .NET 6 i nowszymi, oferując ten sam zestaw funkcji we wszystkich środowiskach uruchomieniowych.

Wskaźniki zaufania

Ostatnia aktualizacja: 2026-05-26
Testowano z: GroupDocs.Comparison 23.12 dla .NET
Autor: GroupDocs

Dodatkowe linki do samouczków (unchanged)

Rozpoczęcie

Ładowanie dokumentu

Podstawowe porównanie

Zaawansowane porównanie

Zarządzanie zmianami

Informacje o dokumencie

Generowanie podglądu

Zarządzanie metadanymi

Bezpieczeństwo i ochrona

Licencjonowanie i konfiguracja

Opcje porównania

Czytaj więcej Czytaj więcej Czytaj więcej Czytaj więcej Czytaj więcej Czytaj więcej Rozpoczęcie Ładowanie dokumentu Podstawowe porównanie Zaawansowane porównanie Zarządzanie zmianami Informacje o dokumencie Generowanie podglądu Zarządzanie metadanymi Bezpieczeństwo i ochrona Licencjonowanie i konfiguracja Opcje porównania Szybki start Rozpoczęcie Porównanie dokumentów i folderów Porównanie dokumentów Ładowanie i zapisywanie dokumentów Porównanie obrazów Podstawowe użycie Szybki start Rozpoczęcie Ładowanie dokumentu Podstawowe porównanie Zaawansowane porównanie Zarządzanie zmianami Informacje o dokumencie Generowanie podglądu Zarządzanie metadanymi Bezpieczeństwo i ochrona Licencjonowanie i konfiguracja Opcje porównania