GroupDocs.Comparison ile .NET’te meta verileri koruma

Bu öğreticide, GroupDocs.Comparison for .NET ile iki belgeyi karşılaştırırken meta verileri nasıl koruyacağınızı öğreneceksiniz. Meta verileri korumak, yasal uyumluluk, denetim izleri ve işbirlikçi iş akışları için esastır ve kütüphane, karşılaştırma sonucunda hangi belgenin meta verilerinin kalacağını ince ayarlı bir şekilde kontrol etmenizi sağlar.

Giriş

İki belgeyi karşılaştırıp süreçte önemli meta verileri kaybettiğiniz oldu mu? Yalnız değilsiniz. .NET uygulamasında belgeleri karşılaştırırken hedef meta verileri korumanız gerektiğinde görev zorlayıcı görünebilir—ama olması gerekmez.

GroupDocs.Comparison for .NET, karşılaştırma sonucunda hangi belgenin meta verilerinin kalacağını belirlemenizi sağlar. İster bir belge yönetim sistemi oluşturuyor olun, ister yasal sözleşmelerle ilgileniyor olun ya da işbirlikçi içerik yönetiyor olun, her seferinde doğru kaynak belgeden meta verileri almak isteyeceksiniz.

Hızlı Yanıtlar

  • “preserve target metadata” ne anlama geliyor? Karşılaştırma sonucu oluşturulurken hedef olarak belirlediğiniz belgeden meta verileri (yazar, oluşturma tarihi, özel özellikler vb.) korur.
  • Hangi GroupDocs.Comparison sürümü gereklidir? Sürüm 25.4.0 veya üzeri.
  • Bunu .NET Core ile kullanabilir miyim? Evet – .NET Core 2.0+ veya .NET Framework 4.6.1+.
  • Üretim için lisans gerekli mi? Üretim için ticari bir lisans gerekir; öğrenme amaçlı ücretsiz deneme sürümü çalışır.
  • Özellik PDF ve DOCX ile çalışır mı? Evet – tüm büyük Office ve PDF formatları meta veri korumayı destekler.

Meta veri korumanın önemi

Koda geçmeden önce, hedef meta verilerini korumanın neden önemli olduğundan bahsedelim. Belge meta verileri sadece “iyi bir özellik” değildir—çoğu zaman yasal olarak zorunlu ya da iş açısından kritik olur:

  • Yasal belgeler – avukat‑müşteri gizlilik işaretlerini korumak gerekir.
  • Kurumsal dosyalar – uyum etiketlerini ve onay zincirlerini tutmak zorundadır.
  • Akademik makaleler – yazar atıfları ve revizyon geçmişi esastır.
  • Teknik dokümantasyon – sürüm kontrolü ve inceleme durumu önemlidir.

Uygun şekilde ele alınmazsa, aylarca oluşturulan bilgileri yanlışlıkla silebilirsiniz. İşte hedef meta verilerini koruma seçeneğinin devreye girdiği yer.

Önkoşullar

Gerekli kütüphaneler ve sürümler

  • GroupDocs.Comparison for .NET: Sürüm 25.4.0 ve üzeri (daha eski sürümler sınırlı meta veri seçeneklerine sahiptir).
  • .NET Framework: 4.6.1 ve üzeri, ya da .NET Core 2.0+.

Ortam kurulumu

  • Visual Studio (veya tercih ettiğiniz herhangi bir C# IDE).
  • Temel C# bilgisi (çok ileri bir şey değil, söz veriyorum!).
  • Test için iki örnek belge (Word .docx harika çalışır).

Bilgi önkoşulları

GroupDocs uzmanı olmanıza gerek yok, ancak şunlarla rahat olmalısınız:

  • C# using ifadeleri ve dosya işleme.
  • Temel belge işleme kavramları.
  • Meta verinin ne olduğu (yazar, başlık, özel özellikler vb.).

Hazır mısınız? Hadi kurulum yapalım.

GroupDocs.Comparison for .NET’i Kurma

GroupDocs.Comparison’ı kurmak basittir, ancak dikkat etmeniz gereken birkaç tuzak vardır.

Kurulum seçenekleri

NuGet Package Manager Console (en kolay yöntem):

Install-Package GroupDocs.Comparison -Version 25.4.0

.NET CLI (komut satırını tercih ediyorsanız):

dotnet add package GroupDocs.Comparison --version 25.4.0

Pro ipucu: Projenizde beklenmedik kırılma değişikliklerinden kaçınmak için her zaman sürümü belirtin.

Lisans edinimi

İşte birçok geliştiricinin başlangıçta takıldığı yer. GroupDocs.Comparison ücretsiz değildir, ancak seçenekleriniz var:

  • Ücretsiz deneme – 30 gün tam işlevsellik, değerlendirme için mükemmel.
  • Geçici lisans – daha fazla zamana ihtiyacınız varsa uzatılmış değerlendirme süresi.
  • Ticari lisans – üretim kullanımı için (çeşitli fiyatlandırma katmanları mevcuttur).

Şu anda lisans konusunda endişelenmeyin, sadece öğreniyorsanız—deneme sürümü tüm hedef meta verilerini koruma özelliklerini içerir.

Temel kurulum doğrulaması

Basit bir testle her şeyin çalıştığından emin olalım:

using System.IO;
using GroupDocs.Comparison;

string sourceFilePath = "source.docx";
string targetFilePath = "target.docx";

// Initialize the Comparer object.
using (Comparer comparer = new Comparer(sourceFilePath))
{
    // Add the target document for comparison.
    comparer.Add(targetFilePath);
}

Bu hatasız derleniyorsa, hazırsınız. Aksi takdirde, paket kurulumunuzu ve using ifadelerinizi tekrar kontrol edin.

Hedef meta verilerini nasıl korursunuz

Kaynak ve hedef dosyalarınızı yükleyin, ardından API’ye hedefin meta verilerini son çıktıda tutmasını söyleyin.

Doğrudan cevap (40‑70 kelime):
Hedef meta verilerini korumak için, kaynak belgeyle bir Comparer nesnesi oluşturun, Add ile hedef belgeyi ekleyin, ComparisonOptions üzerinde CloneMetadataType = MetadataType.Target ayarlayın ve sonunda Compare metodunu çağırın. Bu, GroupDocs.Comparison’a hedef dosyadan yazar, oluşturma tarihi, özel özellikler ve diğer tüm meta verileri oluşturulan sonuca kopyalamasını söyler.

Meta veri akışını anlama

Tipik bir karşılaştırma sırasında:

  1. Kaynak belge temel içeriği sağlar.
  2. Hedef belge karşılaştırılacak değişiklikleri sağlar.
  3. Çıktı belgesi ikisini birleştirir, ancak meta verileri kim kazanır?

Varsayılan olarak, GroupDocs.Comparison kaynak belgenin meta verilerini kullanır. Hedef meta verilerini korumak için API’ye açıkça söylemeniz gerekir.

Adım adım uygulama

Adım 1: Karşılaştırıcı nesnenizi başlatın

Comparer, karşılaştırma sürecini yöneten temel sınıftır. Kaynak dosyayı yükler, değişiklikleri izler ve çıktıyı oluşturur.

using (Comparer comparer = new Comparer(sourceFilePath))
{
    // All comparison operations happen within this scope
}

Neden using ifadeleri kullanılır? Büyük belgeler işlenirken kaynakları otomatik olarak serbest bırakarak bellek sızıntılarını önler. 50 MB Word dosyalarıyla uğraşırken kendinize daha sonra teşekkür edeceksiniz.

Adım 2: Hedef belgeyi ekleyin

Comparer.Add, karşılaştırmak istediğiniz değişiklikleri içeren dosyayı kaydeder.

comparer.Add(targetFilePath);

Yaygın hata: Kaynak ve hedefi karıştırmak. Şöyle düşünün—kaynak “orijinal”iniz, hedef “güncellenmiş sürümünüz”.

Adım 3: Meta veri tipini ayarlayın (büyü burada gerçekleşir)

CloneMetadataType, ComparisonOptions içinde, hangi belgenin meta verilerinin sonuca kopyalanacağını belirleyen bir özelliktir.

comparer.Compare(outputFileName, new SaveOptions() { CloneMetadataType = MetadataType.Target });

Ne oluyor? CloneMetadataType = MetadataType.Target GroupDocs.Comparison’a: “Hey, final sonucumda hedef belgenin meta verilerini tutmak istiyorum.” diye söyler.

Tam çalışan örnek

İşte her şey bir çalıştırılabilir programda bir arada:

using System;
using System.IO;
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;

class Program
{
    static void Main(string[] args)
    {
        try
        {
            string sourceFile = "original_document.docx";
            string targetFile = "updated_document.docx";
            string outputFile = "comparison_result.docx";
            
            using (Comparer comparer = new Comparer(sourceFile))
            {
                comparer.Add(targetFile);
                
                // Preserve target document metadata
                comparer.Compare(outputFile, new SaveOptions() 
                { 
                    CloneMetadataType = MetadataType.Target 
                });
                
                Console.WriteLine($"Comparison completed! Check {outputFile}");
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error during comparison: {ex.Message}");
        }
    }
}

Kaçınılması gereken yaygın tuzaklar

  • Dosya yolu sorunları – her zaman tam yollar kullanın veya dosyalarınızın çalışma dizininde olduğundan emin olun:
// Good
string sourceFile = Path.Combine(Directory.GetCurrentDirectory(), "docs", "source.docx");

// Risky (might work locally but fail in production)
string sourceFile = "source.docx";

  • Bellek yönetimi – büyük belgeler için, Comparer nesnelerini her zaman using ifadeleriyle sarın.

  • Sürüm uyumluluğu – farklı GroupDocs.Comparison sürümleri farklı meta veri seçenekleri sunar—en iyi sonuçlar için 25.4.0 ve üzeri sürüm kullanın.

Gelişmiş meta veri senaryoları

Hedef vs. kaynak meta verileri ne zaman kullanılmalı

SenaryoHedef meta verileri tercih edinKaynak meta verileri tercih edin
Güncellenmiş yazar bilgisi gerekli✅❌
Orijinal belgenin yasal önceliği var❌✅
Özel özellikler yalnızca yeni dosyada eklenmiş✅❌
“Ana” belgenin geçmişini tutmak istiyorsunuz❌✅

Birden fazla hedef belgeyi işleme

İlk eklediğiniz hedefin meta verilerini korurken birden fazla hedefe karşı karşılaştırma yapabilirsiniz:

using (Comparer comparer = new Comparer(sourceFilePath))
{
    comparer.Add(targetFilePath1);
    comparer.Add(targetFilePath2);
    comparer.Add(targetFilePath3);
    
    // Metadata will come from the first target document
    comparer.Compare(outputFileName, new SaveOptions() 
    { 
        CloneMetadataType = MetadataType.Target 
    });
}

Pratik uygulamalar ve kullanım örnekleri

Yasal belge yönetimi

Hukuk firmaları genellikle sözleşme sürümlerini karşılaştırırken belirli meta veri işaretlerini korumaları gerekir:

// Preserve client metadata from updated contract
using (Comparer comparer = new Comparer("original_contract.docx"))
{
    comparer.Add("client_revised_contract.docx");
    
    comparer.Compare("final_contract_comparison.docx", new SaveOptions() 
    { 
        CloneMetadataType = MetadataType.Target  // Keep client's metadata
    });
}

Akademik ve araştırma işbirliği

Birden fazla araştırmacı işbirliği yaptığında, en son yazar bilgisini korumak istersiniz:

// Keep metadata from the researcher's latest submission
using (Comparer comparer = new Comparer("draft_paper.docx"))
{
    comparer.Add("researcher_updates.docx");
    
    comparer.Compare("paper_comparison.docx", new SaveOptions() 
    { 
        CloneMetadataType = MetadataType.Target  // Preserve researcher metadata
    });
}

Kurumsal uyum iş akışları

Düzenlenmiş sektörlerde, uyum meta verilerini sürdürmek kritiktir:

// Preserve compliance tags from updated policy document
using (Comparer comparer = new Comparer("old_policy.docx"))
{
    comparer.Add("compliance_approved_policy.docx");
    
    comparer.Compare("policy_comparison.docx", new SaveOptions() 
    { 
        CloneMetadataType = MetadataType.Target  // Keep compliance metadata
    });
}

Yaygın sorunların giderilmesi

“Dosya bulunamadı” hataları

En yaygın sorun. Açık kontrollerle hata ayıklayın:

string sourceFile = "source.docx";

// Always check if files exist before comparison
if (!File.Exists(sourceFile))
{
    Console.WriteLine($"Source file not found: {Path.GetFullPath(sourceFile)}");
    return;
}

// Same for target files
if (!File.Exists(targetFile))
{
    Console.WriteLine($"Target file not found: {Path.GetFullPath(targetFile)}");
    return;
}

Büyük belgelerde bellek sorunları

10 MB üzerindeki belgeler için şu iyileştirmeleri düşünün:

// Use explicit disposal for large documents
using (var comparer = new Comparer(sourceFile))
{
    comparer.Add(targetFile);
    
    var saveOptions = new SaveOptions() 
    { 
        CloneMetadataType = MetadataType.Target 
    };
    
    comparer.Compare(outputFile, saveOptions);
    
    // Explicitly clean up
    GC.Collect();
    GC.WaitForPendingFinalizers();
}

İzin ve erişim sorunları

Korunan dosyalar veya ağ paylaşımlarıyla çalışırken:

try
{
    using (var comparer = new Comparer(sourceFile))
    {
        comparer.Add(targetFile);
        comparer.Compare(outputFile, new SaveOptions() 
        { 
            CloneMetadataType = MetadataType.Target 
        });
    }
}
catch (UnauthorizedAccessException ex)
{
    Console.WriteLine("Access denied. Check file permissions.");
    Console.WriteLine($"Details: {ex.Message}");
}
catch (IOException ex)
{
    Console.WriteLine("File I/O error occurred.");
    Console.WriteLine($"Details: {ex.Message}");
}

Performans düşünceleri ve en iyi uygulamalar

Bellek yönetimi

GroupDocs.Comparison, 100 sayfalık bir PDF işlediğinde 300 MB RAM tüketebilir. using ifadelerini kullanarak serbest bırakmayı garantileyin ve belleği hızlıca boşaltın.

// Good - automatic resource cleanup
using (var comparer = new Comparer(sourceFile))
{
    // comparison logic here
}

// Bad - potential memory leaks
var comparer = new Comparer(sourceFile);
// ... comparison logic
// comparer.Dispose(); // Easy to forget!

Belgeleri toplu işleyin – birçok dosyayı karşılaştırıyorsanız, bellek kullanımını düşük tutmak için daha küçük gruplar halinde işleyin.

Daha iyi yanıt verebilirlik için async işlemler

Masaüstü veya web uygulamaları için, karşılaştırmayı async bir yöntemde sarın:

public async Task<bool> CompareDocumentsAsync(string source, string target, string output)
{
    return await Task.Run(() =>
    {
        try
        {
            using (var comparer = new Comparer(source))
            {
                comparer.Add(target);
                comparer.Compare(output, new SaveOptions() 
                { 
                    CloneMetadataType = MetadataType.Target 
                });
                return true;
            }
        }
        catch
        {
            return false;
        }
    });
}

Dosya boyutu yönergeleri

  • Küçük (< 1 MB) – doğrudan işleyin.
  • Orta (1‑10 MB) – UI’nin yanıt vermesini sağlamak için ilerleme gösterin.
  • Büyük (> 10 MB) – her zaman async işleme kullanın ve yukarıda gösterildiği gibi açık GC’yi düşünün.

Büyük sistemlerle entegrasyon

ASP.NET Core entegrasyonu

Aşağıda iki yüklenmiş dosyayı kabul eden, karşılaştırmayı çalıştıran ve sonucu hedef meta verilerini koruyarak döndüren hazır bir denetleyici bulunmaktadır:

[ApiController]
[Route("api/[controller]")]
public class DocumentComparisonController : ControllerBase
{
    [HttpPost("compare-with-target-metadata")]
    public async Task<IActionResult> CompareWithTargetMetadata(
        IFormFile sourceFile, 
        IFormFile targetFile)
    {
        var tempSource = Path.GetTempFileName();
        var tempTarget = Path.GetTempFileName();
        var outputPath = Path.GetTempFileName();
        
        try
        {
            // Save uploaded files temporarily
            await sourceFile.CopyToAsync(new FileStream(tempSource, FileMode.Create));
            await targetFile.CopyToAsync(new FileStream(tempTarget, FileMode.Create));
            
            // Perform comparison with target metadata preservation
            using (var comparer = new Comparer(tempSource))
            {
                comparer.Add(tempTarget);
                comparer.Compare(outputPath, new SaveOptions() 
                { 
                    CloneMetadataType = MetadataType.Target 
                });
            }
            
            // Return comparison result
            var resultBytes = await System.IO.File.ReadAllBytesAsync(outputPath);
            return File(resultBytes, "application/vnd.openxmlformats-officedocument.wordprocessingml.document", 
                       "comparison_result.docx");
        }
        finally
        {
            // Clean up temporary files
            if (System.IO.File.Exists(tempSource)) System.IO.File.Delete(tempSource);
            if (System.IO.File.Exists(tempTarget)) System.IO.File.Delete(tempTarget);
            if (System.IO.File.Exists(outputPath)) System.IO.File.Delete(outputPath);
        }
    }
}

Sıkça Sorulan Sorular

Q: Birden fazla hedef belgeden meta verileri koruyabilir miyim?
A: Birkaç hedef dosya eklediğinizde, GroupDocs.Comparison eklenen ilk hedef belgenin meta verilerini kullanır. Meta verilerini tutmak istediğiniz belgeyi zincirde ilk ekleyin.

Q: Hedef belge bazı meta veri alanlarına sahip değilse ne olur?
A: Hedefte mevcut olan meta veriler yalnızca çıktıya kopyalanır. Eksik alanlar basitçe atlanır; karşılaştırma yine de başarılı olur.

Q: Şifre korumalı belgelerle nasıl başa çıkılır?
A: LoadOptions, korumalı belgeleri açmak için şifre gibi ayarları belirtir. Şifreyle bir LoadOptions nesnesi oluşturun ve ardından Comparer yapıcısına geçirin:

var loadOptions = new LoadOptions() { Password = "your_password" };
using (var comparer = new Comparer(sourceFile, loadOptions))
{
    // comparison logic here
}

Q: Sadece seçili meta veri özelliklerini korumanın bir yolu var mı?
A: Mevcut API, seçilen kaynaktan (Hedef veya Kaynak) tüm meta verileri korur. Daha ince bir kontrol için, karşılaştırmadan sonra özellikleri çıkarmanız ve manuel olarak yeniden uygulamanız gerekir.

Q: Hangi belge formatları meta veri korumayı destekler?
A: Çoğu yaygın iş formatı—DOCX, PDF, PPTX, XLSX ve daha fazlası—meta veri korumayı destekler. Tam liste için resmi dokümantasyona bakın.

Q: Sorunlarla karşılaşırsam nereden yardım alabilirim?
A: Topluluk desteği için GroupDocs Destek Forumunu ziyaret edin veya ticari lisansınız varsa GroupDocs desteğiyle doğrudan iletişime geçin.

Ek kaynaklar

Son Güncelleme: 2026-09-15
Test edildi: GroupDocs.Comparison 25.4.0 for .NET
Yazar: GroupDocs

İlgili Öğreticiler