Tích hợp vào một ứng dụng web ASP.NET Core cho phép chỉnh sửa tài liệu liền mạch trực tiếp trong cổng thông tin web của bạn. GroupDocs.Editor Cloud SDK for .NET cung cấp một API mạnh mẽ cho phép bạn tải, chỉnh sửa và lưu các tệp DOCX trên máy chủ. Hướng dẫn này sẽ đưa bạn qua quá trình thiết lập cần thiết, hiển thị mã từng bước và cung cấp một ví dụ hoàn chỉnh mà bạn có thể chạy trong vài phút. Khi kết thúc, bạn sẽ có thể thêm chức năng chỉnh sửa tài liệu vào ứng dụng ASP.NET Core một cách tự tin.

Các yêu cầu và thiết lập

Trước khi bắt đầu, hãy chắc chắn rằng bạn đã có những thứ sau:

  • .NET 6.0 SDK hoặc phiên bản mới hơn đã được cài đặt
  • Một IDE như Visual Studio 2022 hoặc VS Code
  • Một tài khoản GroupDocs Cloud để lấy Client Id và Client Secret
  • Truy cập vào máy phát triển Windows, Linux hoặc macOS

Việc tích hợp vào một ứng dụng web ASP.NET Core cũng yêu cầu một kết nối mạng ổn định tới các endpoint của GroupDocs Cloud, vì tất cả quá trình xử lý tài liệu diễn ra từ xa. Hãy lên kế hoạch môi trường triển khai của bạn cho phù hợp.

Cài đặt SDK qua NuGet:

dotnet add package GroupDocs.editor-Cloud

Tải xuống gói mới nhất từ trang phát hành chính thức: GroupDocs.Editor Cloud SDK for .NET Tải xuống.

Tạo một đối tượng cấu hình với thông tin xác thực của bạn (trích đoạn từ ví dụ đầy đủ):

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

Với gói đã được cài đặt và thông tin xác thực đã sẵn sàng, bạn có thể tiến tới việc triển khai. Các phần tiếp theo sẽ giải thích chi tiết từng đoạn mã, để bạn hiểu cách thư viện tích hợp vào kiến trúc tổng thể của một ứng dụng web ASP.NET Core.

Hướng dẫn từng bước tích hợp vào ứng dụng web ASP.NET Core

Phần này phân tích quy trình tích hợp vào một ứng dụng web ASP.NET Core thành các bước rời rạc, dễ quản lý. Mỗi bước bao gồm một đoạn mã ngắn được lấy trực tiếp từ triển khai tham chiếu.

Bước 1: Cấu hình thông tin xác thực API

Đầu tiên, khởi tạo đối tượng Configuration với thông tin chi tiết của khách hàng và tạo client EditorApi.

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

var editorApi = new EditorApi(configuration);

Lớp EditorApi được tài liệu hoá trong tài liệu API. Khởi tạo client một lần cho mỗi yêu cầu là đủ cho hầu hết các kịch bản; bạn cũng có thể đăng ký nó như một singleton trong container tiêm phụ thuộc ASP.NET Core để cải thiện hiệu năng.

Bước 2: Định nghĩa tùy chọn tải

Chỉ định tệp nguồn và vị trí đầu ra mong muốn bằng cách sử dụng LoadOptions. Đối tượng này cho dịch vụ biết tài liệu nào sẽ được mở và nơi lưu trữ HTML đã được render.

var loadOptions = new LoadOptions
{
    FileInfo = new FileInfo { FilePath = "input.docx" },
    RenderOptions = new RenderOptions { OutputPath = "output.html" }
};

LoadOptions, FileInfo, và RenderOptions cho phép bạn kiểm soát cách tài liệu được hiển thị để chỉnh sửa. Ví dụ, bạn có thể đặt RenderOptions để bao gồm hình ảnh, giữ nguyên kiểu dáng gốc, hoặc giới hạn số trang được hiển thị.

Bước 3: Gọi LoadDocument

Gọi API để tải và chuyển đổi tài liệu. Lệnh gọi này là đồng bộ trong ví dụ này, nhưng bạn cũng có thể sử dụng phiên bản bất đồng bộ nếu hành động controller của bạn là async.

var loadResult = editorApi.LoadDocument(loadOptions);

Phương thức LoadDocument trả về một đối tượng kết quả chứa các URL tới HTML đã được render và các siêu dữ liệu khác. Bạn có thể lưu loadResult để truy xuất sau hoặc truyền HTML trực tiếp tới front‑end.

Bước 4: Xử lý kết quả tải

Sau khi tải, bạn có thể phục vụ HTML cho giao diện người dùng hoặc lưu lại để sử dụng sau. Bước này hoàn thành quy trình tích hợp trình chỉnh sửa tài liệu vào ứng dụng web ASP.NET Core và chuẩn bị tài liệu cho tương tác của người dùng.

Trong một kịch bản thực tế, bạn thường sẽ trả về nội dung HTML từ một hành động của controller:

return Content(loadResult.HtmlContent, "text/html");

Bạn cũng có thể muốn triển khai bộ nhớ đệm để tránh re‑loading cùng một tài liệu nhiều lần, điều này có thể cải thiện thời gian phản hồi khi tích hợp vào một ứng dụng web ASP.NET Core ở quy mô lớn.

Tích hợp Trình chỉnh sửa tài liệu vào ASP.NET Core Web Application - Ví dụ mã đầy đủ

Đoạn mã sau đây minh họa toàn bộ quy trình từ cấu hình đến việc tải tệp DOCX.

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

var editorApi = new EditorApi(configuration);

var loadOptions = new LoadOptions
{
    FileInfo = new FileInfo { FilePath = "input.docx" },
    RenderOptions = new RenderOptions { OutputPath = "output.html" }
};

var loadResult = editorApi.LoadDocument(loadOptions);

Lưu ý: Ví dụ mã này minh họa chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy đảm bảo cập nhật mọi đường dẫn tệp và giá trị cấu hình để phù hợp với môi trường thực tế của bạn, xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển. Nếu gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.

Sử dụng cURL để tích hợp chỉnh sửa tài liệu ASP.NET Core

Nếu bạn thích cách tiếp cận REST trực tiếp, cùng một thao tác có thể được thực hiện bằng các lệnh cURL. Phương pháp này hữu ích cho việc tạo mẫu nhanh hoặc khi bạn cần tích hợp trình chỉnh sửa vào một dịch vụ không được viết bằng .NET.

1. Xác thực và nhận mã truy cập

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

Phản hồi chứa một access_token được sử dụng trong các cuộc gọi tiếp theo.

2. Tải lên tệp nguồn

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/storage/upload?path=/input.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@input.docx"

3. Tải tài liệu để chỉnh sửa

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/load" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.docx" },
           "renderOptions": { "outputPath": "output.html" }
         }'

4. Tải xuống HTML đã render

curl -X GET "https://api.groupdocs.cloud/v2.0/editor/storage/download?path=/output.html" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.html

Các lệnh này minh họa cách thêm chức năng chỉnh sửa tài liệu vào ứng dụng ASP.NET Core mà không cần viết bất kỳ mã C# nào, hữu ích cho việc kiểm tra nhanh hoặc tích hợp với các dịch vụ khác. Để biết thêm chi tiết, xem tài liệu API chính thức.

Bằng cách thành thạo cả thư viện .NET và API REST thô, bạn sẽ có tính linh hoạt khi tích hợp vào một ứng dụng web ASP.NET Core, cho phép bạn chọn cách tiếp cận phù hợp nhất với kiến trúc của mình.

Câu hỏi thường gặp

Đọc thêm