So sánh tài liệu Word C# với So sánh Luồng trong .NET

Giới thiệu

Nếu bạn cần compare word documents c# trong một ứng dụng .NET đồng thời giữ mức sử dụng bộ nhớ thấp, bạn đã đến đúng nơi. So sánh dựa trên tệp truyền thống buộc toàn bộ tài liệu phải được tải vào RAM, điều này nhanh chóng trở thành nút thắt cho các tệp Word lớn hoặc các kịch bản đám mây‑native nơi bạn chỉ có một luồng. Hướng dẫn này sẽ chỉ cho bạn, từng bước, cách thực hiện so sánh tài liệu dựa trên luồng bằng GroupDocs.Comparison, kèm theo các ví dụ thực tế, mẹo hiệu năng và hướng dẫn khắc phục sự cố.

Trả lời nhanh

  • Thư viện nào hỗ trợ so sánh luồng? GroupDocs.Comparison cho .NET.
  • Tôi có thể so sánh tệp Word trực tiếp từ MemoryStream không? Có – chỉ cần truyền luồng cho bộ so sánh.
  • Tôi có cần giấy phép cho môi trường production không? Chắc chắn; giấy phép GroupDocs.Comparison hợp lệ sẽ loại bỏ watermark.
  • Các phiên bản .NET nào được hỗ trợ? .NET Framework 4.6.1+, .NET Core 2.0+, .NET 5/6/7.
  • Có hỗ trợ async tích hợp không? Không nguyên bản, nhưng bạn có thể bọc các lời gọi trong Task.Run để có hành vi async cơ bản.

So sánh tài liệu dựa trên luồng

Lớp Comparer trong GroupDocs.Comparison đọc dữ liệu tài liệu từ bất kỳ triển khai Stream nào, cho phép so sánh mà không cần ghi tệp ra đĩa. Điều này làm cho nó trở nên lý tưởng cho lưu trữ đám mây, xử lý tệp lớn và các dịch vụ web có độ đồng thời cao.

Tại sao nên dùng so sánh dựa trên luồng để so sánh tài liệu Word C#?

So sánh dựa trên luồng giảm áp lực bộ nhớ bằng cách xử lý dữ liệu theo từng khối thay vì tải toàn bộ tệp. GroupDocs.Comparison hỗ trợ hơn 50 định dạng đầu vào và đầu ra—bao gồm DOCX, PDF, PPTX và XLSX—và có thể xử lý các tài liệu hàng trăm trang mà không làm cạn kiệt RAM của máy chủ. Cách tiếp cận này cũng hoàn toàn phù hợp với Azure Blob, AWS S3, hoặc bất kỳ lưu trữ dựa trên HTTP nào mà bạn nhận được một Stream thay vì đường dẫn tệp vật lý.

Yêu cầu trước

  • GroupDocs.Comparison cho .NET (Phiên bản 25.4.0 trở lên) – hỗ trợ hơn 50 định dạng.
  • .NET Framework 4.6.1+ hoặc .NET Core 2.0+ (bao gồm .NET 5/6/7).
  • Một IDE hỗ trợ C# (Visual Studio, VS Code, hoặc Rider).
  • Kiến thức cơ bản về các luồng C# (FileStream, MemoryStream) và câu lệnh using.

Cài đặt GroupDocs.Comparison cho .NET

Các bước cài đặt

Sử dụng NuGet Package Manager Console

Install-Package GroupDocs.Comparison -Version 25.4.0

Install-Package GroupDocs.Comparison -Version 25.4.0

Sử dụng .NET CLI

dotnet add package GroupDocs.Comparison --version 25.4.0

dotnet add package GroupDocs.Comparison --version 25.4.0

Mẹo chuyên nghiệp: Ghim số phiên bản để tránh các thay đổi phá vỡ không mong muốn khi một bản phát hành mới xuất hiện.

Cài đặt giấy phép (Quan trọng!)

GroupDocs.Comparison yêu cầu giấy phép cho việc sử dụng trong môi trường production. Bạn có thể bắt đầu với bản dùng thử miễn phí, nhận giấy phép tạm thời cho công việc chứng minh khái niệm, hoặc mua giấy phép đầy đủ cho các triển khai không giới hạn. Truy cập Mua GroupDocs để biết chi tiết.

Khởi tạo giấy phép cơ bản

var license = new GroupDocs.Comparison.License();
license.SetLicense("GroupDocs.Comparison.lic");

using GroupDocs.Comparison;
using System.IO;

// This is your foundation for all comparisons
Comparer comparer = new Comparer();

Bây giờ bạn đã sẵn sàng để so sánh tài liệu từ bất kỳ nguồn luồng nào.

Cách so sánh tài liệu Word C# bằng Luồng?

Tải các tệp Word nguồn và đích của bạn dưới dạng luồng, truyền chúng cho Comparer, và ghi kết quả vào một luồng đầu ra. Quy trình hoàn chỉnh được minh họa dưới đây.

Bước 1: Chuẩn bị các luồng nguồn, đích và đầu ra

using (var sourceStream = File.OpenRead("Original.docx"))
using (var targetStream = File.OpenRead("Revised.docx"))
using (var resultStream = File.Create("ComparisonResult.docx"))
{
    // Comparison logic goes here
}

string sourceDocumentPath = Path.Combine("YOUR_DOCUMENT_DIRECTORY", "source.docx");
string targetDocumentPath = Path.Combine("YOUR_DOCUMENT_DIRECTORY", "target.docx");
string outputDirectory = Path.Combine("YOUR_OUTPUT_DIRECTORY", ".");
string outputFileName = Path.Combine(outputDirectory, "comparison_result.docx");

using (Comparer comparer = new Comparer(File.OpenRead(sourceDocumentPath)))
{
    // Step 2: Add the Target Document
    comparer.Add(File.OpenRead(targetDocumentPath));

    // Step 3: Perform Comparison and Save Results
    comparer.Compare(File.Create(outputFileName));
}

Giải thích:

  • File.OpenRead tạo các luồng chỉ đọc cho hai tệp Word.
  • File.Create mở một luồng chỉ ghi nơi kết quả so sánh sẽ được lưu.
  • Các câu lệnh using đảm bảo mỗi luồng được giải phóng ngay khi khối kết thúc, ngăn chặn khóa tệp và rò rỉ bộ nhớ.

Bước 2: Khởi tạo Comparer với luồng nguồn

var comparer = new GroupDocs.Comparison.Comparer(sourceStream);

// Example: Comparing documents from byte arrays
byte[] sourceBytes = GetDocumentFromDatabase(sourceId);
byte[] targetBytes = GetDocumentFromDatabase(targetId);

using (var sourceStream = new MemoryStream(sourceBytes))
using (var targetStream = new MemoryStream(targetBytes))
using (var outputStream = new MemoryStream())
using (var comparer = new Comparer(sourceStream))
{
    comparer.Add(targetStream);
    comparer.Compare(outputStream);
    
    // Now you can work with the result in memory
    byte[] resultBytes = outputStream.ToArray();
}

Định nghĩa: Lớp Comparer là thành phần cốt lõi của GroupDocs.Comparison, chịu trách nhiệm tải, phân tích và tạo ra các khác biệt giữa hai hoặc nhiều luồng tài liệu.

Bước 3: Thêm luồng đích

comparer.Add(targetStream);

// If you must reuse a stream, reset its position
stream.Position = 0;

Bạn có thể gọi Add nhiều lần để so sánh nguồn với một số phiên bản đích trong một lần chạy.

Bước 4: Thực hiện so sánh và ghi kết quả

ComparisonResult đại diện cho kết quả của một lần so sánh, chứa tài liệu diff và siêu dữ liệu liên quan.

var result = comparer.Compare();
result.Save(resultStream);

// Good - automatic disposal
using (var stream = File.OpenRead(path))
{
    // Use stream
}

// Also good - manual disposal
var stream = File.OpenRead(path);
try
{
    // Use stream
}
finally
{
    stream?.Dispose();
}

Điều gì xảy ra ở đây?

  • Compare() xử lý cả hai luồng, phát hiện các chèn, xóa và thay đổi định dạng, và trả về một đối tượng ComparisonResult.
  • Save() ghi tài liệu so sánh được đánh dấu vào resultStream mà bạn đã tạo trước đó.

Xử lý luồng nâng cao

Làm việc với MemoryStream (ví dụ, tệp được tải lên qua HTTP)

Khi ứng dụng của bạn nhận được một tệp tải lên, bạn thường nhận được một MemoryStream. API này hoạt động mà không cần sửa đổi:

var uploadedSource = new MemoryStream(await httpRequest.Form.Files[0].OpenReadStream().ReadAllBytesAsync());
var uploadedTarget = new MemoryStream(await httpRequest.Form.Files[1].OpenReadStream().ReadAllBytesAsync());

var comparer = new GroupDocs.Comparison.Comparer(uploadedSource);
comparer.Add(uploadedTarget);
var result = comparer.Compare();

await result.SaveAsync(response.Body);

if (stream.CanSeek)
{
    // Safe to use Position and Length properties
}

Tại sao điều này quan trọng: Sử dụng MemoryStream loại bỏ nhu cầu tạo tệp tạm thời trên đĩa, giúp cải thiện hiệu năng trong các dịch vụ web không trạng thái và môi trường container.

Những khó khăn thường gặp và giải pháp

Rủi ro #1: Vị trí luồng không được đặt lại

Vấn đề: Nếu một luồng đã được đọc trước đó (ví dụ, để xác thực), vị trí của nó có thể ở cuối, gây ra việc bộ so sánh đọc 0 byte.
Giải pháp: Đặt lại vị trí trước khi truyền luồng:

sourceStream.Position = 0;
targetStream.Position = 0;

// Example of async file reading (though GroupDocs.Comparison doesn't support async yet)
var sourceBytes = await File.ReadAllBytesAsync(sourcePath);
using (var sourceStream = new MemoryStream(sourceBytes))
{
    // Comparison logic
}

Rủi ro #2: Quên giải phóng luồng

Vấn đề: Các luồng không được giải phóng sẽ giữ mở các handle tệp, dẫn đến lỗi “file in use”.
Giải pháp: Luôn bao bọc các luồng trong khối using hoặc gọi Dispose() một cách rõ ràng, như đã minh họa trong triển khai cốt lõi.

Rủi ro #3: Sử dụng luồng không hỗ trợ Seek

Vấn đề: Một số luồng mạng (ví dụ, NetworkStream) không hỗ trợ seek, mà bộ so sánh có thể yêu cầu.
Giải pháp: Sao chép luồng không hỗ trợ seek vào một MemoryStream trước:

var seekableStream = new MemoryStream();
await nonSeekableStream.CopyToAsync(seekableStream);
seekableStream.Position = 0;

[HttpPost]
public async Task<IActionResult> CompareDocuments(IFormFile sourceFile, IFormFile targetFile)
{
    using (var sourceStream = sourceFile.OpenReadStream())
    using (var targetStream = targetFile.OpenReadStream())
    using (var outputStream = new MemoryStream())
    using (var comparer = new Comparer(sourceStream))
    {
        comparer.Add(targetStream);
        comparer.Compare(outputStream);
        
        return File(outputStream.ToArray(), "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "comparison.docx");
    }
}

Thực hành tốt về hiệu năng

Tối ưu hóa sử dụng bộ nhớ

  • Tinh chỉnh kích thước bộ đệm: Đối với các tài liệu lớn hơn 50 MB, tăng kích thước bộ đệm nội bộ lên 1 MB để giảm số vòng đọc‑ghi.
  • I/O bất đồng bộ: Trong ASP.NET Core, sử dụng các API tệp bất đồng bộ (FileStream.OpenReadAsync) để giải phóng các luồng trong quá trình I/O.

Giám sát tiêu thụ tài nguyên

  • Bộ đếm hiệu năng: Theo dõi Process.PrivateMemorySize64 trước và sau khi so sánh để xác minh ảnh hưởng tới bộ nhớ.
  • Kiểm thử hiệu năng: Chạy các bài kiểm thử dotnet benchmark so sánh các cách tiếp cận dựa trên tệp và dựa trên luồng; các lần chạy dựa trên luồng thường nhanh hơn 20‑30 % trên các tệp DOCX 200 trang.

Kiểm soát đồng thời

  • Hệ thống hàng đợi: Giới hạn số lần so sánh đồng thời bằng số lõi CPU để tránh sự cố hết bộ nhớ.
  • Giải phóng sớm: Giải phóng các luồng nguồn và đích ngay sau khi Compare() trả về; luồng kết quả có thể để mở cho đến khi bạn ghi nó cho client.

Các trường hợp sử dụng thực tế

Trường hợp sử dụng 1: Đánh giá tài liệu trong ứng dụng web

Một nền tảng SaaS cho phép người dùng tải lên hai phiên bản của hợp đồng để xem xét song song. Các tệp tải lên đến dưới dạng các đối tượng IFormFile, được chuyển đổi thành MemoryStream và so sánh ngay lập tức, trả về một tệp DOCX có thể tải xuống với các thay đổi được theo dõi.

Trường hợp sử dụng 2: Xử lý hàng loạt từ lưu trữ đám mây

Một Azure Function được kích hoạt khi có blob mới trong một container, đọc mỗi blob dưới dạng luồng, so sánh với phiên bản gốc lưu trong một container khác, và ghi kết quả so sánh trở lại vào container “results”.

Trường hợp sử dụng 3: Tích hợp kiểm soát phiên bản

Một pipeline DevOps trích xuất các tệp Word từ kho Git, truyền chúng dưới dạng luồng vào GroupDocs.Comparison, và tạo báo cáo diff được đính kèm vào artifact của build cho các kiểm toán viên.

Hướng dẫn khắc phục sự cố

Vấn đềNguyên nhân có thểCách khắc phục
“Stream does not support reading”Đã truyền luồng chỉ‑ghi (ví dụ, File.OpenWrite)Sử dụng File.OpenRead hoặc đảm bảo CanRead là true.
“Object reference not set to an instance of an object”Luồng null hoặc đã được giải phóng trước khi so sánhKiểm tra việc khởi tạo luồng và giữ khối using mở cho đến sau khi Compare().
Hiệu năng kém trên các tệp >100 MBKích thước bộ đệm mặc định quá nhỏ, hoặc quá nhiều tác vụ đồng thờiTăng kích thước bộ đệm, giới hạn đồng thời, và phân tích với dotMemory.
Lỗi giấy phép trong productionThiếu file giấy phép hoặc đường dẫn không đúngĐặt GroupDocs.Comparison.lic trong thư mục gốc của ứng dụng và gọi SetLicense sớm trong quá trình khởi động.
Dữ liệu luồng bị hỏngGián đoạn mạng khi tải xuống từ lưu trữ đám mâyXác thực độ dài và checksum của luồng trước khi so sánh.

Tùy chọn cấu hình nâng cao

var options = new CompareOptions
{
    HighlightColor = Color.Yellow,
    ShowDeletedContent = true,
    ShowInsertedContent = true,
    StyleChangeDetection = true,
    Password = "optionalPassword"
};
var comparer = new GroupDocs.Comparison.Comparer(sourceStream, options);

public async Task<byte[]> CompareCloudDocuments(string sourceUrl, string targetUrl)
{
    using (var httpClient = new HttpClient())
    using (var sourceStream = await httpClient.GetStreamAsync(sourceUrl))
    using (var targetStream = await httpClient.GetStreamAsync(targetUrl))
    using (var outputStream = new MemoryStream())
    using (var comparer = new Comparer(sourceStream))
    {
        comparer.Add(targetStream);
        comparer.Compare(outputStream);
        return outputStream.ToArray();
    }
}

Định nghĩa: CompareOptions là một đối tượng cấu hình cho phép bạn kiểm soát kiểu dáng hiển thị, bảo vệ bằng mật khẩu, và các loại thay đổi sẽ được báo cáo.

Tích hợp với các framework .NET phổ biến

Tích hợp ASP.NET Core

public async Task<IActionResult> Compare(IFormFile source, IFormFile target)
{
    using var sourceStream = new MemoryStream();
    using var targetStream = new MemoryStream();
    await source.CopyToAsync(sourceStream);
    await target.CopyToAsync(targetStream);
    sourceStream.Position = 0;
    targetStream.Position = 0;

    var comparer = new GroupDocs.Comparison.Comparer(sourceStream);
    comparer.Add(targetStream);
    var result = comparer.Compare();

    var output = new MemoryStream();
    result.Save(output);
    output.Position = 0;
    return File(output, "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
                "ComparisonResult.docx");
}

public DocumentComparisonResult CompareDocumentVersions(int documentId, int version1, int version2)
{
    var doc1Stream = GetDocumentVersionStream(documentId, version1);
    var doc2Stream = GetDocumentVersionStream(documentId, version2);
    
    using (doc1Stream)
    using (doc2Stream)
    using (var outputStream = new MemoryStream())
    using (var comparer = new Comparer(doc1Stream))
    {
        comparer.Add(doc2Stream);
        comparer.Compare(outputStream);
        
        return new DocumentComparisonResult
        {
            ComparisonData = outputStream.ToArray(),
            ComparedAt = DateTime.UtcNow,
            SourceVersion = version1,
            TargetVersion = version2
        };
    }
}

Tích hợp Windows Forms / WPF

var openFileDialog = new OpenFileDialog { Filter = "Word files (*.docx)|*.docx" };
if (openFileDialog.ShowDialog() == DialogResult.OK)
{
    using var source = File.OpenRead(openFileDialog.FileName);
    // Repeat for target, then compare as shown earlier
}

using (var comparer = new Comparer(sourceStream))
{
    comparer.Add(targetStream);
    
    var compareOptions = new CompareOptions
    {
        ShowDeletedContent = true,
        ShowInsertedContent = true,
        GenerateSummaryPage = true
    };
    
    comparer.Compare(outputStream, compareOptions);
}

Kết luận

So sánh tài liệu dựa trên luồng trong .NET cung cấp cho bạn một cách tiết kiệm bộ nhớ, sẵn sàng cho đám mây, và hiệu năng cao để so sánh các tệp Word. Bằng cách tận dụng lớp Comparer của GroupDocs.Comparison, bạn có thể làm việc trực tiếp với các đối tượng Stream, tránh các tệp tạm thời, và mở rộng lên hàng nghìn so sánh đồng thời. Tuân thủ các thực hành tốt đã nêu ở trên—giải phóng luồng đúng cách, tinh chỉnh bộ đệm, và giấy phép—để đảm bảo triển khai production vững chắc.

Tài nguyên

Cập nhật lần cuối: 2026-05-31
Kiểm tra với: GroupDocs.Comparison 25.4.0 for .NET
Tác giả: GroupDocs

public class DocumentComparisonService
{
    public async Task<ComparisonResult> CompareDocumentsAsync(Stream source, Stream target)
    {
        // Your comparison logic here
        // This is where the earlier examples would fit
    }
}

private void CompareButton_Click(object sender, EventArgs e)
{
    using (var openFileDialog = new OpenFileDialog())
    {
        if (openFileDialog.ShowDialog() == DialogResult.OK)
        {
            using (var stream = File.OpenRead(openFileDialog.FileName))
            {
                // Perform comparison
            }
        }
    }
}

Hướng dẫn liên quan