Bạn có thể thêm văn bản hoặc hình ảnh dưới dạng hình nền mờ vào tài liệu Word của mình theo chương trình trên đám mây. Hình mờ được sử dụng để xác định người tạo tài liệu hoặc các thông tin khác như bản quyền hoặc biểu tượng, v.v. Thông thường, hình mờ được sử dụng ở dạng hình ảnh, biểu trưng, mẫu hoặc văn bản chồng lên nhau được đặt bên trong tài liệu. Trong bài viết này, bạn sẽ tìm hiểu cách thêm hình mờ vào tài liệu Word bằng API REST trong C#.
Các chủ đề sau đây sẽ được đề cập trong bài viết này:
- Watermark REST API và .NET SDK
- Thêm hình mờ văn bản vào tài liệu Word bằng API REST trong C#
- Thêm hình mờ vào tài liệu Word bằng API REST
Watermark REST API và .NET SDK
Để thêm hình mờ văn bản hoặc hình ảnh vào tệp DOCX, tôi sẽ sử dụng API .NET SDK của GroupDocs.Watermark Cloud. Nó cho phép bạn lập trình thêm, xóa, tìm kiếm và thay thế các hình mờ khỏi hình ảnh và tài liệu của các định dạng tệp được hỗ trợ như PDF, Microsoft Word và Powerpoint. Hơn nữa, bạn có thể kiểm soát việc tùy chỉnh hình mờ bằng cách chỉ định kiểu văn bản, phông chữ, kích thước, màu sắc hoặc vị trí theo yêu cầu của bạn. Hiện tại, nó cũng cung cấp Java SDK cho Cloud API.
Bạn có thể cài đặt GroupDocs.Watermark Cloud vào dự án Visual Studio của mình từ Trình quản lý gói NuGet hoặc sử dụng lệnh sau trong bảng điều khiển Trình quản lý gói:
Install-Package GroupDocs.Watermark-Cloud
Vui lòng lấy Mã khách hàng và Bí mật của bạn từ bảng điều khiển trước khi làm theo các bước được đề cập. Khi bạn có ID và bí mật của mình, hãy thêm mã như hình bên dưới:
string clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
string clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
string myStorage = "";
var configuration = new Configuration(clientId, clientSecret);
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
Thêm hình mờ văn bản vào tài liệu Word bằng API REST trong C#
Bạn có thể thêm bất kỳ văn bản nào dưới dạng hình mờ vào tài liệu Word của mình theo cách lập trình bằng cách thực hiện theo các bước đơn giản được đề cập bên dưới:
- Tải lên the DOCX file to the Cloud
- Thêm Hình mờ Văn bản vào DOCX bằng C#
- Tải xuống the watermarked file
Tải lên tài liệu
Đầu tiên, tải tài liệu Word lên Đám mây bằng ví dụ mã được cung cấp bên dưới:
// khởi tạo api
var fileApi = new FileApi(configuration);
// mở tập tin
var fileStream = File.Open(@"C:\Files\sample.docx", FileMode.Open);
// tạo yêu cầu tải lên tập tin
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);
// cập nhật dử liệu
fileApi.UploadFile(request);
fileStream.Close();
Do đó, tệp DOCX sẽ được tải lên bộ nhớ đám mây và sẽ có trong phần tệp trên trang tổng quan của bạn.
Thêm hình mờ văn bản vào DOCX bằng C#
Bạn có thể thêm hình mờ văn bản vào tệp DOCX theo cách lập trình bằng cách thực hiện theo các bước dưới đây.
- Tạo một phiên bản của WatermarkApi
- Tạo một phiên bản của FileInfo
- Đặt đường dẫn tệp DOCX
- Tạo WatermarkOptions và đặt FileInfo
- Tạo TextWatermarkOptions
- Đặt văn bản, họ phông chữ, cỡ chữ và căn chỉnh văn bản
- Đặt màu nền trước của văn bản hình mờ
- Xác định vị trí hình mờ
- Xác định WatermarkDetails và đặt TextWatermarkOptions và Vị trí
- Tạo AddRequest với WatermarkOptions
- Nhận kết quả bằng cách gọi phương thức WatermarkApi.add()
Mẫu mã sau đây cho biết cách thêm văn bản dưới dạng hình nền mờ vào tài liệu Word bằng API REST trong C#.
// khởi tạo api
var apiInstance = new WatermarkApi(configuration);
// đường dẫn tệp đầu vào
var fileInfo = new FileInfo
{
FilePath = "sample.docx"
};
// tạo tùy chọn hình mờ
var options = new WatermarkOptions()
{
FileInfo = fileInfo,
// xác định chi tiết hình mờ
WatermarkDetails = new List<WatermarkDetails>
{
new WatermarkDetails
{
// xác định hình mờ văn bản
TextWatermarkOptions = new TextWatermarkOptions
{
Text = "Copyright© 2021",
FontFamilyName = "Arial",
FontSize = 22d,
TextAlignment = "Center",
ForegroundColor = new Color()
{
Name = "Red"
}
},
// đặt vị trí hình mờ
Position = new Position()
{
X = 230.0,
Y = 500.0
}
}
}
};
// tạo thêm yêu cầu
var request = new AddRequest(options);
// thêm hình mờ
var response = apiInstance.Add(request);
Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Thêm hình mờ văn bản vào tài liệu Word bằng API REST trong C#
Tải xuống tệp cập nhật
Mẫu mã trên sẽ lưu tệp Word với hình mờ văn bản trên đám mây. Bạn có thể tải xuống bằng mẫu mã sau:
// khởi tạo api
var fileApi = new FileApi(configuration);
// đường dẫn tệp mặc định trên đám mây
var file = "watermark/added_watermark/sample_docx/sample.docx";
// tạo yêu cầu tệp tải xuống
var downloadRequest = new DownloadFileRequest(file, myStorage);
// Tải tập tin
Stream downloadResponse = fileApi.DownloadFile(downloadRequest);
// lưu tệp trong thư mục làm việc
using (var fileStream = System.IO.File.Create("C:\\Files\\DownloadedFile.docx"))
{
downloadResponse.Seek(0, SeekOrigin.Begin);
downloadResponse.CopyTo(fileStream);
}
Thêm hình mờ vào tài liệu Word bằng API REST
Bạn có thể thêm hình ảnh hoặc logo dưới dạng hình nền mờ vào tài liệu Word của mình theo cách lập trình bằng cách làm theo các bước dưới đây.
- Tạo một phiên bản của WatermarkApi
- Tạo một phiên bản của FileInfo
- Đặt đường dẫn tệp DOCX
- Tạo WatermarkOptions và đặt FileInfo
- Tạo hình ảnh WatermarkOptions
- Đặt FilePath của hình ảnh PNG thành hình mờ với
- Xác định vị trí hình mờ
- Tạo chi tiết hình mờ
- Đặt ImageWatermarkOptions và Vị trí
- Đặt chi tiết hình mờ thành danh sách
- Tạo AddRequest với WatermarkOptions
- Nhận kết quả bằng cách gọi phương thức WatermarkApi.add()
Mẫu mã sau đây cho biết cách thêm hình ảnh dưới dạng hình mờ vào DOCX bằng cách sử dụng API REST trong C#. Vui lòng làm theo các bước được đề cập trước đó để tải lên và tải xuống các tệp.
// khởi tạo api
var apiInstance = new WatermarkApi(configuration);
// đường dẫn tệp đầu vào
var fileInfo = new FileInfo
{
FilePath = "sample.docx"
};
// tạo tùy chọn hình mờ
var options = new WatermarkOptions()
{
FileInfo = fileInfo,
// xác định chi tiết hình mờ
WatermarkDetails = new List<WatermarkDetails>
{
new WatermarkDetails
{
// xác định hình mờ hình ảnh
ImageWatermarkOptions = new ImageWatermarkOptions()
{
Image = new FileInfo {
FilePath = "logo.png"
}
},
// đặt vị trí hình mờ
Position = new Position()
{
X = 180.0,
Y = 280.0
}
}
}
};
// tạo thêm yêu cầu
var request = new AddRequest(options);
// thêm hình mờ
var response = apiInstance.Add(request);
Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Thêm hình mờ vào tài liệu Word bằng API REST trong C#
Thử trực tuyến
Vui lòng dùng thử công cụ Watermark trực tuyến miễn phí sau đây, được phát triển bằng cách sử dụng API ở trên. https://products.groupdocs.app/watermark/docx
Phần kết luận
Tóm lại, bạn đã học cách thêm hình mờ văn bản hoặc hình ảnh vào tài liệu Word trên đám mây. Bạn cũng đã học cách lập trình tải lên các tệp DOCX trên đám mây và sau đó tải xuống tệp đã cập nhật từ đám mây. Bạn có thể tìm hiểu thêm về GroupDocs.Watermark Cloud API từ tài liệu. Chúng tôi cũng cung cấp phần Tham khảo API cho phép bạn hình dung và tương tác trực tiếp với các API của chúng tôi thông qua trình duyệt. Trong trường hợp có bất kỳ sự mơ hồ nào, vui lòng liên hệ với hỗ trợ.