Porównywanie dokumentów .NET: Akceptowanie i odrzucanie zmian programowo

Jeśli nadal ręcznie porównujesz dokumenty i śledzisz zmiany wzrokiem, tracisz cenne godziny, które mogłyby być poświęcone prawdziwemu rozwojowi. Automatyzuj przepływ dokumentów dzięki solidnemu rozwiązaniu do porównywania dokumentów .NET, a zmniejszysz ręczną pracę nawet o 90 %. Niezależnie od tego, czy budujesz system zarządzania treścią, obsługujesz przegląd dokumentów prawnych, czy zarządzasz przepływami współpracy edytorskiej, programowe porównywanie dokumentów nie jest tylko miłym dodatkiem — jest niezbędne dla każdej poważnej aplikacji.

Szybkie odpowiedzi

• Jaką bibliotekę obsługuje śledzenie zmian w .NET? GroupDocs.Comparison for .NET.
• Jak długo trwa początkowa konfiguracja? Około 5 minut przy użyciu NuGet.
• Czy mogę porównywać pliki Word i PDF razem? Tak — obsługiwane jest ponad 50 formatów wejściowych i wyjściowych.
• Czy przetwarzanie wsadowe jest możliwe? Absolutnie; możesz przetwarzać dziesiątki plików w jednej pętli.
• Czy potrzebna jest licencja do produkcji? Tak — pełna licencja usuwa ograniczenia wersji próbnej i odblokowuje wszystkie funkcje.

Dlaczego porównywanie dokumentów ma znaczenie (i dlaczego prawdopodobnie robisz to źle)

Jeśli nadal ręcznie porównujesz dokumenty i śledzisz zmiany wzrokiem, tracisz cenne godziny, które mogłyby być poświęcone prawdziwemu rozwojowi. Oto co: rozwiązania document comparison .NET mogą zautomatyzować 90 % problemów z przepływem dokumentów, a ja pokażę Ci dokładnie, jak to zrobić.

Niezależnie od tego, czy budujesz system zarządzania treścią, obsługujesz przegląd dokumentów prawnych, czy zarządzasz przepływami współpracy edytorskiej, programowe porównywanie dokumentów nie jest tylko miłym dodatkiem — jest niezbędne dla każdej poważnej aplikacji.

Do końca tego samouczka będziesz wiedział, jak:

• Skonfigurować funkcjonalność porównywania dokumentów .NET w ciągu minut (nie godzin)
• Akceptować i odrzucać zmiany programowo z precyzją chirurgiczną
• Radzić sobie z rzeczywistymi scenariuszami, które sprawiają problemy większości programistów
• Optymalizować wydajność przy obsłudze dużych zestawów dokumentów
• Rozwiązywać typowe problemy zanim zakłócą Twój projekt

Zanurzmy się — zaczynając od tego, czego potrzebujesz, aby to działało.

Zanim zaczniesz: Niezbędne wymagania wstępne

Oto, czego będziesz potrzebował, aby podążać za instrukcją (i faktycznie uruchomić to w swoim projekcie):

• .NET Framework 4.6.1 lub nowszy – starsze wersje nie wystarczą
• Podstawowa znajomość C# – powinieneś czuć się komfortowo z klasami i metodami
• Visual Studio (lub preferowane IDE) skonfigurowane i gotowe
• 5 minut na zainstalowanie pakietu GroupDocs

Konfiguracja GroupDocs.Comparison dla .NET (właściwy sposób)

Większość samouczków pomija tutaj niuanse, ale prawidłowa konfiguracja oszczędza późniejsze bóle głowy związane z debugowaniem. Oto jak zrobić to poprawnie:

Opcje instalacji

Opcja 1: Konsola Menedżera Pakietów NuGet (zalecane)

Install-Package GroupDocs.Comparison -Version 25.4.0

Opcja 2: .NET CLI (jeśli wolisz wiersz poleceń)

dotnet add package GroupDocs.Comparison --version 25.4.0

Licencjonowanie (nie pomijaj tego kroku)

Tutaj wielu programistów napotyka problemy. GroupDocs.Comparison wymaga odpowiedniej licencji do użytku produkcyjnego. Twoje opcje:

1. Rozpocznij od wersji próbnej – idealna do testów: Download here
2. Uzyskaj tymczasową licencję – do dłuższej oceny: Request here
3. Pełna licencja – do wdrożenia produkcyjnego: Purchase here

Podstawowa konfiguracja i inicjalizacja

GroupDocs.Comparison jest klasą rdzeniową, która koordynuje wszystkie operacje porównywania. Po dodaniu pakietu NuGet musisz jedynie utworzyć instancję i wskazać pliki, które chcesz porównać.

using GroupDocs.Comparison;

To wszystko w kwestii konfiguracji. Proste, prawda? Teraz przejdźmy do ciekawej części — faktycznego porównywania dokumentów i zarządzania zmianami.

Kompletny przewodnik implementacji

Tutaj przechodzimy do praktyki. Przeprowadzę Cię przez rzeczywistą implementację, którą możesz dostosować do swoich potrzeb.

Zrozumienie przepływu akceptacji/odrzucania

Zanim przejdziemy do kodu, wyjaśnijmy, co budujemy. Document comparison .NET z GroupDocs działa w następujący sposób:

1. Porównaj dwa dokumenty, aby zidentyfikować różnice
2. Analizuj zmiany wykryte podczas porównania
3. Zdecyduj, które zmiany zaakceptować lub odrzucić
4. Zastosuj swoje decyzje, aby wygenerować dokument końcowy

Ten przepływ pracy daje Ci precyzyjną kontrolę nad wersjami dokumentów — idealny do procesów zatwierdzania, współpracy edytorskiej lub automatycznego zarządzania treścią.

Implementacja krok po kroku

Krok 1: Skonfiguruj ścieżki plików (zrób to prawidłowo)

Upewnij się, że używasz ścieżek bezwzględnych lub poprawnie rozwiązywanych ścieżek względnych; w przeciwnym razie napotkasz FileNotFoundException.

string documentDirectory = "YOUR_DOCUMENT_DIRECTORY";
string outputDirectory = "YOUR_OUTPUT_DIRECTORY";

string sourceFilePath = Path.Combine(documentDirectory, "SOURCE_WORD");
string targetFilePath = Path.Combine(documentDirectory, "TARGET_WORD");
string acceptedChangesOutputFile = Path.Combine(outputDirectory, "RESULT_WITH_ACCEPTED_CHANGE_WORD");
string rejectedChangesOutputFile = Path.Combine(outputDirectory, "RESULT_WITH_REJECTED_CHANGE_WORD");

Krok 2: Zainicjuj porównanie i wykryj zmiany

Obiekt Comparison ładuje zarówno plik źródłowy, jak i docelowy, uruchamia silnik różnicowy i zwraca kolekcję ChangesInfo, opisującą każdą modyfikację.

ChangesInfo to kolekcja zawierająca szczegółowe informacje o każdej wykrytej modyfikacji, takie jak typ, lokalizacja i autor.

using (Comparer comparer = new Comparer(sourceFilePath))
{
    comparer.Add(targetFilePath);
    comparer.Compare();
    ChangeInfo[] changes = comparer.GetChanges();
}

Krok 3: Jak odrzucić zmiany programowo?

Załaduj kolekcję ChangesInfo, znajdź zmianę, którą chcesz odrzucić, ustaw jej Action na ComparisonAction.Reject i zapisz wynik.

ComparisonAction to wyliczenie określające, czy zmiana ma być zaakceptowana, odrzucona, czy pozostawiona bez zmian.

changes[0].ComparisonAction = ComparisonAction.Reject;
comparer.ApplyChanges(rejectedChangesOutputFile, new ApplyChangeOptions { Changes = changes, SaveOriginalState = true });

Dlaczego SaveOriginalState = true? To zachowuje oryginalne formatowanie i strukturę — kluczowe dla utrzymania integralności dokumentu, gdy później zdecydujesz się zaakceptować inne zmiany.

Krok 4: Jak zaakceptować wybrane zmiany?

Wybierz żądane obiekty zmian, ustaw Action na ComparisonAction.Accept i wywołaj Save.

changes[0].ComparisonAction = ComparisonAction.Accept;
comparer.ApplyChanges(acceptedChangesOutputFile, new ApplyChangeOptions { Changes = changes });

Wskazówki dotyczące implementacji w rzeczywistych scenariuszach

Przetwarzanie wsadowe wielu zmian

// Accept all insertions, reject all deletions
foreach (var change in changes)
{
    if (change.Type == ChangeType.Inserted)
        change.ComparisonAction = ComparisonAction.Accept;
    else if (change.Type == ChangeType.Deleted)
        change.ComparisonAction = ComparisonAction.Reject;
}

Warunkowe zarządzanie zmianami – np. akceptowanie tylko zmian wprowadzonych przez określonego autora lub w określonym zakresie stron.

// Only accept changes from specific authors
foreach (var change in changes)
{
    if (change.Authors.Contains("TrustedUser"))
        change.ComparisonAction = ComparisonAction.Accept;
    else
        change.ComparisonAction = ComparisonAction.Reject;
}

Typowe problemy i jak je naprawić

Problemy ze ścieżkami plików

Objawy: FileNotFoundException lub błędy odmowy dostępu
Rozwiązanie: Zawsze weryfikuj, czy ścieżki plików istnieją i czy aplikacja ma uprawnienia do odczytu/zapisu.

if (!File.Exists(sourceFilePath))
    throw new FileNotFoundException($"Source file not found: {sourceFilePath}");

Problemy z pamięcią przy dużych dokumentach

Objawy: OutOfMemoryException podczas przetwarzania dużych plików
Rozwiązanie: Przetwarzaj dokumenty w częściach, włącz tryb strumieniowania lub zwiększ limit pamięci procesu.

// Configure comparison settings for large files
CompareOptions options = new CompareOptions()
{
    DetectStyleChanges = false, // Reduces memory usage
    GenerateSummaryPage = false
};

Nieobsługiwane formaty dokumentów

Objawy: wyjątki „Format not supported”
Rozwiązanie: Sprawdź kompatybilność formatu przed przetwarzaniem; GroupDocs.Comparison obsługuje ponad 50 formatów, w tym DOCX, PDF, PPTX, XLSX i zwykły tekst.

var supportedFormats = new[] { ".docx", ".doc", ".pdf", ".txt" };
string extension = Path.GetExtension(sourceFilePath).ToLower();
if (!supportedFormats.Contains(extension))
    throw new NotSupportedException($"Format {extension} not supported");

Praktyczne przypadki użycia, które naprawdę mają znaczenie

1. Przegląd dokumentów prawnych

Kancelarie prawne wykorzystują to podejście do zarządzania zmianami w umowach. Senior partnerzy mogą programowo akceptować określone zmiany klauzul, odrzucając inne na podstawie zdefiniowanych reguł biznesowych.

2. Systemy zarządzania treścią

Platformy wydawnicze używają document comparison .NET do obsługi przepływów redakcyjnych. Autorzy przesyłają poprawki, redaktorzy przeglądają zmiany programowo, a tylko zatwierdzona treść zostaje opublikowana.

3. Dokumentacja współpracy przy tworzeniu oprogramowania

Zespoły technicznego pisania używają tego do zarządzania aktualizacjami dokumentacji. Zmiany od zaufanych współtwórców są automatycznie akceptowane, inne wymagają ręcznego przeglądu.

4. Zgodność i ścieżki audytu

Organizacje tworzą szczegółowe logi zmian, programowo analizując modyfikacje dokumentów. Zapewnia to pełną ścieżkę audytu dla zgodności regulacyjnej.

Optymalizacja wydajności: przyspiesz działanie

Najlepsze praktyki zarządzania pamięcią

// Always dispose properly
using (Comparer comparer = new Comparer(sourceFilePath))
{
    // Your comparison logic here
} // Automatically disposed here

Strategia przetwarzania wsadowego

Dla wielu dokumentów:

// Process in batches to avoid memory overload
const int batchSize = 10;
for (int i = 0; i < documents.Count; i += batchSize)
{
    var batch = documents.Skip(i).Take(batchSize);
    ProcessDocumentBatch(batch);
    GC.Collect(); // Force garbage collection between batches
}

Dostosowanie konfiguracji

Dostosuj silnik porównywania, aby wyłączyć niepotrzebne funkcje (np. porównanie metadanych) i zmniejszyć zużycie pamięci.

CompareOptions options = new CompareOptions()
{
    DetectStyleChanges = false,        // Skip formatting changes for speed
    GenerateSummaryPage = false,       // Skip summary generation  
    CalculateCoordinates = false       // Skip position calculations
};

Zaawansowane techniki dla zaawansowanych użytkowników

Niestandardowe filtrowanie zmian

// Create custom filters for specific change types
var importantChanges = changes.Where(c => 
    c.Type == ChangeType.Inserted && 
    c.Text.Length > 10 &&
    !c.Text.Contains("temp")).ToArray();

Zautomatyzowane reguły decyzyjne

// Implement business rules for automatic decisions
public ComparisonAction DecideOnChange(ChangeInfo change)
{
    if (change.Authors.Contains("Admin")) return ComparisonAction.Accept;
    if (change.Text.Contains("TODO")) return ComparisonAction.Reject;
    return ComparisonAction.None; // Manual review needed
}

Podsumowanie: Twój zestaw narzędzi Document Comparison .NET

Masz teraz wszystko, co potrzebne, aby wdrożyć profesjonalne porównywanie dokumentów w aplikacjach .NET. Najważniejsze wnioski:

• GroupDocs.Comparison zajmuje się ciężką pracą analizy dokumentów
• Programowe akceptowanie/odrzucanie daje precyzyjną kontrolę nad zmianami
• Optymalizacja wydajności jest kluczowa dla aplikacji produkcyjnych
• Solidna obsługa błędów chroni przed koszmarami wsparcia technicznego

Co dalej?

Rozpocznij od prostego proof of concept z własnymi dokumentami. Gdy opanujesz podstawowy przepływ pracy, odkryj zaawansowane funkcje, takie jak porównywanie stylów, wykrywanie formatowania i niestandardowe typy zmian. Prawdziwa moc automate document workflow polega na budowaniu skalowalnych procesów, które rosną wraz z potrzebami Twojego biznesu.

Najczęściej zadawane pytania

Q: Jakie formaty dokumentów obsługuje GroupDocs.Comparison?
A: Obsługuje Word (.docx, .doc), Excel (.xlsx, .xls), PowerPoint (.pptx, .ppt), PDF, zwykły tekst i wiele innych — ponad 50 formatów w sumie. Zobacz pełną listę formatów po szczegóły.

Q: Czy mogę używać tego w aplikacjach ASP.NET Core?
A: Oczywiście! GroupDocs.Comparison działa bezproblemowo z ASP.NET Core, Web API i innymi nowoczesnymi frameworkami .NET.

Q: Jak radzić sobie z bardzo dużymi dokumentami, nie wyczerpując pamięci?
A: Skorzystaj z wymienionych wyżej technik optymalizacji: wyłącz niepotrzebne funkcje porównywania, przetwarzaj pliki w partiach i jawnie zwalniaj obiekty Comparison po każdym uruchomieniu.

Q: Czy istnieje sposób podglądu zmian przed ich zastosowaniem?
A: Tak! Kolekcja ChangesInfo zawiera szczegółowe metadane każdej zmiany, w tym oryginalny i zmieniony tekst. Możesz stworzyć interfejs, który podświetli te różnice przed zatwierdzeniem.

Q: Jaka jest różnica między akcjami Accept i Reject?
A: Accept włącza zmianę do dokumentu końcowego (zachowując nową wersję). Reject odrzuca zmianę i zachowuje oryginalną treść. Ustawienie ComparisonAction.None pozostawia zmianę nieoznaczoną.

Q: Czy mogę zintegrować to z systemami kontroli wersji, takimi jak Git?
A: Chociaż GroupDocs.Comparison nie integruje się bezpośrednio z Gitem, możesz stworzyć przepływ pracy, który porównuje pliki z różnych gałęzi, generuje raport zmian i zatwierdza zaakceptowaną wersję z powrotem do repozytorium.

Q: Czy istnieją jakieś ograniczenia licencyjne, o których powinienem wiedzieć?
A: Wersja próbna oferuje pełną funkcjonalność, ale jest ograniczona do 30 dni i 5 jednoczesnych użytkowników. Wdrożenia produkcyjne wymagają płatnej licencji; ceny różnią się w zależności od scenariusza wdrożenia.

Q: Jak dokładne jest wykrywanie zmian?
A: Zmiany tekstowe są wykrywane z dokładnością > 99 %. Wykrywanie stylu i formatowania zależy od wybranej konfiguracji; możesz włączyć szczegółowe porównywanie stylów dla krytycznych dokumentów.

Dodatkowe zasoby

• Pobierz tutaj
• Zamów tutaj
• Kup tutaj
• pełna lista formatów
• Dokumentacja GroupDocs.Comparison
• Kompletny przewodnik API
• Pobierz GroupDocs.Comparison
• Kup tutaj
• Wypróbuj teraz
• Zamów tutaj
• Uzyskaj pomoc

Ostatnia aktualizacja: 2026-07-01
Testowano z: GroupDocs.Comparison 23.10 for .NET
Autor: GroupDocs

Powiązane samouczki

• Akceptuj/Odrzuć zmiany w dokumentach Word .NET
• Śledź zmiany w dokumentach .NET - Kompletny przewodnik zarządzania autorami
• Automatyzacja porównywania dokumentów C# - Kompletny przewodnik GroupDocs.Comparison