bandingkan dokumen .net – Tutorial Lengkap GroupDocs.Comparison untuk Pengembang .NET
Jika Anda perlu compare documents .net secara programatis, Anda telah berada di panduan yang tepat.
Menemukan perbedaan secara manual antara dua versi kontrak, spreadsheet, atau presentasi dapat memakan berjam-jam dan masih melewatkan perubahan halus. Dengan GroupDocs.Comparison untuk .NET Anda dapat mengotomatisasi tugas ini, menghasilkan laporan perbedaan visual, dan bahkan menerima atau menolak perubahan tanpa membuka file secara manual. Tutorial ini memandu Anda melalui setiap langkah—dari menginstal paket NuGet hingga menangani perbandingan folder skala besar—sehingga Anda dapat menyematkan perbandingan dokumen yang andal ke dalam solusi .NET apa pun.
Jawaban Cepat
- What is the primary purpose of GroupDocs.Comparison? Untuk membandingkan dokumen secara programatis, mendeteksi perubahan, dan menghasilkan hasil perbedaan visual atau berbasis data.
- Can I accept or reject changes automatically? Ya—gunakan API accept/reject untuk menerapkan kontrol granular.
- Does the library support image comparison in .NET? Tentu saja; Anda dapat membandingkan screenshot, render UI, dan gambar raster apa pun.
- Is folder comparison possible? Ya—bandingkan seluruh folder untuk menemukan file yang ditambahkan, dihapus, atau dimodifikasi.
- What do I need before starting? Lingkungan pengembangan .NET, paket NuGet, dan lisensi GroupDocs.Comparison yang valid (tersedia versi percobaan).
Apa itu compare documents .net?
compare documents .net adalah proses mengidentifikasi perbedaan secara programatis antara dua atau lebih versi dokumen menggunakan perpustakaan .NET. GroupDocs.Comparison mengimplementasikan ini dengan memuat file sumber dan target, menerapkan opsi perbandingan yang dapat dikonfigurasi, dan mengembalikan ComparisonResult yang berisi sorotan visual serta daftar perubahan terstruktur. ComparisonResult mewakili hasil perbandingan, berisi perubahan yang terdeteksi dan data perbedaan visual.
Mengapa memilih GroupDocs.Comparison untuk .NET?
GroupDocs.Comparison mendukung lebih dari 50 format, memproses PDF besar dalam hitungan detik, dan menyertakan fitur tingkat perusahaan seperti penanganan kata sandi, pelestarian metadata, dan manajemen perubahan yang detail, menghilangkan kebutuhan akan banyak perpustakaan khusus dan mengurangi upaya pengembangan.
Prasyarat
- Visual Studio 2022 atau lebih baru (atau IDE yang kompatibel dengan .NET).
- .NET 6+ runtime (perpustakaan juga mendukung .NET Core 3.1 dan .NET Framework 4.8).
- Paket NuGet
GroupDocs.Comparison(versi stabil terbaru). - Kunci lisensi yang valid (Anda dapat memulai dengan percobaan 30‑hari).
Bagaimana cara membandingkan dua dokumen .net?
Untuk membandingkan dua dokumen .net, buat instance kelas Comparer, panggil Compare(sourcePath, targetPath, outputPath), dan tentukan ComparisonOptions yang Anda perlukan. Metode ini membuat file diff yang menyoroti penyisipan, penghapusan, dan perubahan format, sekaligus menyediakan koleksi Changes untuk inspeksi programatis. Objek Comparer adalah mesin inti yang menggerakkan proses perbandingan.
Langkah‑demi‑langkah
- Create a
Comparerinstance – ini adalah objek inti yang menggerakkan mesin perbandingan. - Load source and target – Anda dapat memberikan jalur file, stream, atau byte array; stream disarankan untuk file yang lebih besar dari 10 MB.
- Configure options – abaikan huruf besar/kecil, tetapkan kata sandi, atau sesuaikan sensitivitas melalui
ComparisonOptions. - Execute the comparison – panggil
Comparedan sediakan lokasi output untuk diff visual. - Process results – baca koleksi
Changesuntuk menerima, menolak, atau mencatat setiap modifikasi.
Format apa yang dapat saya bandingkan dengan GroupDocs.Comparison?
GroupDocs.Comparison mendukung lebih dari 50 format input dan output, termasuk DOCX, PDF, XLSX, PPTX, PNG, JPEG, BMP, dan TIFF. Ia juga dapat menangani file yang dilindungi kata sandi dan file yang disimpan di penyimpanan cloud (melalui API stream). Lingkup ini menghilangkan kebutuhan akan banyak perpustakaan saat membangun pipeline pemrosesan dokumen universal.
Bagaimana saya dapat menerima atau menolak perubahan secara programatis?
Objek ComparisonResult menampilkan koleksi Changes. Setiap item ChangeInfo menggambarkan satu perubahan yang terdeteksi dan menyediakan metode Accept() dan Reject(). Panggil result.Changes.AcceptAll() untuk menerapkan semua perubahan yang terdeteksi ke dokumen target, atau iterasi result.Changes dan panggil Accept() atau Reject() pada objek ChangeInfo individual untuk kontrol yang detail. Setelah menerapkan tindakan yang diinginkan, simpan dokumen yang diperbarui dengan result.Save(outputPath).
Bagaimana cara membandingkan seluruh folder .net?
Perbandingan folder melibatkan iterasi pasangan file yang cocok dan memanggil logika Compare yang sama untuk setiap pasangan. GroupDocs.Comparison juga menyediakan metode bantu CompareFolders(sourceFolder, targetFolder, outputFolder) yang membandingkan semua file yang cocok di dua direktori, mendeteksi file yang ditambahkan atau dihapus, dan menghasilkan hasil diff. CompareFolders mengembalikan koleksi objek FolderComparisonResult, masing‑masing menunjukkan status pasangan file dan tautan ke dokumen diff‑nya.
Bagaimana cara kerja perbandingan gambar di .NET?
Modul gambar memperlakukan setiap piksel sebagai titik data, menghasilkan gambar diff yang menyoroti wilayah yang berubah dengan warna merah dan mengembalikan skor kesamaan (0‑100 %). Panggil Comparer.CompareImages(imagePath1, imagePath2, outputPath); mesin menyelaraskan gambar, menghitung perbedaan per‑piksel, menulis gambar diff di mana piksel yang diubah diwarnai, dan menyediakan nilai Similarity yang dapat Anda gunakan untuk memicu peringatan atau melewatkan proses lebih lanjut jika perubahan di bawah ambang batas.
Kasus Penggunaan Umum
- Version control for non‑code assets – pertahankan jejak audit yang jelas dari revisi kontrak.
- Automated compliance checks – tandai penyuntingan tidak sah dalam dokumen kebijakan.
- CI/CD pipelines for UI testing – bandingkan screenshot halaman web antar build.
- Batch migration projects – verifikasi bahwa file yang dikonversi mempertahankan konten asli.
Tips Kinerja untuk Dokumen Besar
- Stream files alih-alih memuatnya sepenuhnya ke memori; ini mengurangi penggunaan RAM puncak hingga 80 %.
- Reuse a single
Comparerinstance untuk beberapa perbandingan guna memanfaatkan caching internal. - Adjust
ComparisonOptions.MemoryLimitsaat menangani dokumen yang lebih besar dari 500 MB untuk mencegah pengecualian out‑of‑memory.
Pertanyaan yang Sering Diajukan
Q: Bagaimana cara menerima atau menolak perubahan secara programatis setelah perbandingan?
A: Gunakan result.Changes.AcceptAll(), RejectAll(), atau iterasi setiap ChangeInfo dan panggil Accept() / Reject() sesuai kebutuhan, kemudian simpan dokumen dengan result.Save(outputPath).
Q: Bisakah saya mengekstrak metadata seperti penulis, tanggal pembuatan, atau properti khusus dari dokumen?
A: Ya—DocumentInfo menyediakan akses ke metadata standar dan khusus untuk file sumber dan target, memungkinkan Anda mencatat atau menampilkan informasi ini.
Q: Apakah memungkinkan membandingkan file gambar (misalnya PNG, JPEG) secara langsung di .NET?
A: Tentu saja. API CompareImages menyoroti perbedaan tingkat piksel dan mengembalikan persentase kesamaan yang dapat Anda gunakan dalam pengujian otomatis.
Q: Bagaimana saya dapat membandingkan seluruh folder untuk menemukan file yang ditambahkan, dihapus, atau dimodifikasi?
A: Panggil Comparer.CompareFolders(sourceFolder, targetFolder, outputFolder); metode ini mengembalikan koleksi objek FolderComparisonResult yang menunjukkan status setiap pasangan file.
Q: Apa yang harus saya lakukan jika perlu membandingkan dokumen yang dilindungi kata sandi?
A: Berikan kata sandi melalui LoadOptions.Password saat memuat setiap dokumen; mesin mendekripsi file secara internal sebelum melakukan diff.
Q: Apakah GroupDocs.Comparison mendukung .NET Core dan .NET 5/6?
A: Ya—perpustakaan kompatibel dengan .NET Core 3.1, .NET 5, .NET 6, dan versi selanjutnya, menawarkan set fitur yang sama di semua runtime.
Sinyal Kepercayaan
Terakhir Diperbarui: 2026-05-26
Diuji Dengan: GroupDocs.Comparison 23.12 for .NET
Penulis: GroupDocs
Tautan Tutorial Tambahan (unchanged)
Perbandingan Dokumen dan Folder
Perbandingan Dokumen
Memuat dan Menyimpan Dokumen
Perbandingan Gambar
Penggunaan Dasar
Mulai Cepat
Memulai
Memuat Dokumen
Perbandingan Dasar
Perbandingan Lanjutan
Manajemen Perubahan
Informasi Dokumen
Pembuatan Pratinjau
Manajemen Metadata
Keamanan & Perlindungan
Lisensi & Konfigurasi
Opsi Perbandingan
Baca Selengkapnya Baca Selengkapnya Baca Selengkapnya Baca Selengkapnya Baca Selengkapnya Baca Selengkapnya Memulai Memuat Dokumen Perbandingan Dasar Perbandingan Lanjutan Manajemen Perubahan Informasi Dokumen Pembuatan Pratinjau Manajemen Metadata Keamanan & Perlindungan Lisensi & Konfigurasi Opsi Perbandingan Mulai Cepat Memulai Perbandingan Dokumen dan Folder Perbandingan Dokumen Memuat dan Menyimpan Dokumen Perbandingan Gambar Penggunaan Dasar Mulai Cepat Memulai Memuat Dokumen Perbandingan Dasar Perbandingan Lanjutan Manajemen Perubahan Informasi Dokumen Pembuatan Pratinjau Manajemen Metadata Keamanan & Perlindungan Lisensi & Konfigurasi Opsi Perbandingan