Anda dapat menambahkan teks atau gambar sebagai tanda air ke dokumen Word Anda secara terprogram di cloud. Watermark digunakan untuk mengidentifikasi pembuat dokumen atau informasi lain seperti hak cipta atau logo, dll. Biasanya watermark digunakan dalam bentuk gambar, logo, pola, atau teks yang ditumpangkan di dalam dokumen. Pada artikel ini, Anda akan mempelajari cara menambahkan watermark ke dokumen Word menggunakan REST API di C#.
Topik-topik berikut akan dibahas dalam artikel ini:
- Watermark REST API dan .NET SDK
- Tambahkan Tanda Air Teks ke Dokumen Word menggunakan REST API di C#
- Tambahkan Tanda Air Gambar ke Dokumen Word menggunakan REST API
Watermark REST API dan .NET SDK
Untuk menambahkan tanda air teks atau gambar ke file DOCX, saya akan menggunakan .NET SDK dari GroupDocs.Watermark Cloud API. Ini memungkinkan Anda untuk menambah, menghapus, mencari, dan mengganti tanda air secara terprogram dari gambar dan dokumen dari format file yang didukung seperti PDF, Microsoft Word, dan Powerpoint. Selain itu, Anda dapat mengontrol penyesuaian tanda air dengan menentukan gaya teks, font, ukuran, warna, atau posisi sesuai kebutuhan Anda. Saat ini, juga menyediakan Java SDK untuk Cloud API.
Anda dapat menginstal GroupDocs.Watermark Cloud ke dalam proyek Visual Studio Anda dari Package Manager NuGet atau menggunakan perintah berikut di konsol Package Manager:
Install-Package GroupDocs.Watermark-Cloud
Dapatkan ID dan Rahasia Klien Anda dari dashboard sebelum mengikuti langkah-langkah yang disebutkan. Setelah Anda memiliki ID dan rahasia Anda, tambahkan kode seperti yang ditunjukkan di bawah ini:
string clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
string clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
string myStorage = "";
var configuration = new Configuration(clientId, clientSecret);
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
Tambahkan Tanda Air Teks ke Dokumen Word menggunakan REST API di C#
Anda dapat menambahkan teks apa pun sebagai tanda air ke dokumen Word Anda secara terprogram dengan mengikuti langkah-langkah sederhana yang disebutkan di bawah ini:
- Mengunggah the DOCX file to the Cloud
- Tambahkan Tanda Air Teks ke DOCX menggunakan C#
- Unduh the watermarked file
Unggah Dokumen
Pertama, unggah dokumen Word ke Cloud menggunakan contoh kode yang diberikan di bawah ini:
// inisialisasi api
var fileApi = new FileApi(configuration);
// membuka file
var fileStream = File.Open(@"C:\Files\sample.docx", FileMode.Open);
// buat permintaan unggah file
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);
// unggah data
fileApi.UploadFile(request);
fileStream.Close();
Hasilnya, file DOCX akan diunggah ke penyimpanan cloud dan akan tersedia di bagian file dasbor Anda.
Tambahkan Tanda Air Teks ke DOCX menggunakan C#
Anda dapat menambahkan tanda air teks ke file DOCX secara terprogram dengan mengikuti langkah-langkah di bawah ini.
- Buat instance dari WatermarkApi
- Buat instance FileInfo
- Tetapkan jalur file DOCX
- Buat WatermarkOptions dan atur FileInfo
- Buat TextWatermarkOptions
- Atur Teks, Keluarga Font, Ukuran Font, dan Perataan Teks
- Atur warna Foreground dari teks tanda air
- Tentukan Posisi tanda air
- Tentukan WatermarkDetails dan atur TextWatermarkOptions dan Position
- Buat AddRequest dengan WatermarkOptions
- Dapatkan hasil dengan memanggil metode WatermarkApi.add().
Contoh kode berikut menunjukkan cara menambahkan teks sebagai watermark ke dokumen Word menggunakan REST API di C#.
// inisialisasi api
var apiInstance = new WatermarkApi(configuration);
// jalur file masukan
var fileInfo = new FileInfo
{
FilePath = "sample.docx"
};
// buat opsi tanda air
var options = new WatermarkOptions()
{
FileInfo = fileInfo,
// menentukan detail tanda air
WatermarkDetails = new List<WatermarkDetails>
{
new WatermarkDetails
{
// menentukan tanda air teks
TextWatermarkOptions = new TextWatermarkOptions
{
Text = "Copyright© 2021",
FontFamilyName = "Arial",
FontSize = 22d,
TextAlignment = "Center",
ForegroundColor = new Color()
{
Name = "Red"
}
},
// atur posisi tanda air
Position = new Position()
{
X = 230.0,
Y = 500.0
}
}
}
};
// buat permintaan tambah
var request = new AddRequest(options);
// tambahkan tanda air
var response = apiInstance.Add(request);
Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Tambahkan Tanda Air Teks ke Dokumen Word menggunakan REST API di C#
Unduh File yang Diperbarui
Contoh kode di atas akan menyimpan file Word dengan watermark teks di cloud. Anda dapat mengunduhnya menggunakan contoh kode berikut:
// inisialisasi api
var fileApi = new FileApi(configuration);
// jalur file default di cloud
var file = "watermark/added_watermark/sample_docx/sample.docx";
// buat permintaan file unduhan
var downloadRequest = new DownloadFileRequest(file, myStorage);
// Unduh berkas
Stream downloadResponse = fileApi.DownloadFile(downloadRequest);
// simpan file di direktori kerja
using (var fileStream = System.IO.File.Create("C:\\Files\\DownloadedFile.docx"))
{
downloadResponse.Seek(0, SeekOrigin.Begin);
downloadResponse.CopyTo(fileStream);
}
Tambahkan Tanda Air Gambar ke Dokumen Word menggunakan REST API
Anda dapat menambahkan gambar atau logo sebagai tanda air ke dokumen Word Anda secara terprogram dengan mengikuti langkah-langkah di bawah ini.
- Buat instance dari WatermarkApi
- Buat instance FileInfo
- Tetapkan jalur file DOCX
- Buat WatermarkOptions dan atur FileInfo
- Buat ImageWatermarkOptions
- Setel FilePath dari gambar PNG ke tanda air
- Tentukan Posisi tanda air
- Buat Detail Tanda Air
- Atur ImageWatermarkOptions dan Position
- Setel Detail Tanda Air ke Daftar
- Buat AddRequest dengan WatermarkOptions
- Dapatkan hasil dengan memanggil metode WatermarkApi.add().
Contoh kode berikut menunjukkan cara menambahkan gambar sebagai watermark ke DOCX menggunakan REST API di C#. Silakan ikuti langkah-langkah yang disebutkan sebelumnya untuk mengunggah dan mengunduh file.
// inisialisasi api
var apiInstance = new WatermarkApi(configuration);
// jalur file masukan
var fileInfo = new FileInfo
{
FilePath = "sample.docx"
};
// buat opsi tanda air
var options = new WatermarkOptions()
{
FileInfo = fileInfo,
// menentukan detail tanda air
WatermarkDetails = new List<WatermarkDetails>
{
new WatermarkDetails
{
// menentukan watermark gambar
ImageWatermarkOptions = new ImageWatermarkOptions()
{
Image = new FileInfo {
FilePath = "logo.png"
}
},
// atur posisi tanda air
Position = new Position()
{
X = 180.0,
Y = 280.0
}
}
}
};
// buat permintaan tambah
var request = new AddRequest(options);
// tambahkan tanda air
var response = apiInstance.Add(request);
Console.WriteLine("Resultant file path: " + response.DownloadUrl);
Tambahkan Tanda Air Gambar ke Dokumen Word menggunakan REST API di C#
Coba Daring
Silakan coba alat Tanda Air online gratis berikut, yang dikembangkan menggunakan API di atas. https://products.groupdocs.app/watermark/docx
Kesimpulan
Sebagai kesimpulan, Anda telah mempelajari cara menambahkan tanda air teks atau gambar ke dokumen Word di cloud. Anda juga telah mempelajari cara mengunggah file DOCX secara terprogram di cloud dan kemudian mengunduh file yang diperbarui dari cloud. Anda dapat mempelajari lebih lanjut tentang GroupDocs.Watermark Cloud API dari dokumentasi. Kami juga menyediakan bagian Referensi API yang memungkinkan Anda memvisualisasikan dan berinteraksi dengan API kami secara langsung melalui browser. Jika ada ambiguitas, jangan ragu untuk menghubungi dukungan.