اضافه کردن واترمارک به اسناد Word با استفاده از REST API در سی شارپ

می توانید یک متن یا یک تصویر را به عنوان واترمارک به اسناد Word خود به صورت برنامه ریزی شده در فضای ابری اضافه کنید. واترمارک برای شناسایی سازنده سند یا سایر اطلاعات مانند کپی رایت یا آرم و غیره استفاده می شود. معمولاً از واترمارک به صورت یک تصویر، آرم، الگو یا متن روی هم قرار داده شده در داخل سند استفاده می شود. در این مقاله، نحوه افزودن واترمارک به اسناد Word با استفاده از REST API در سی شارپ را خواهید آموخت.

موضوعات زیر در این مقاله پوشش داده خواهد شد:

• Watermark REST API و NET SDK
• اضافه کردن واترمارک متنی به اسناد Word با استفاده از REST API در سی شارپ
• اضافه کردن واترمارک تصویر به اسناد Word با استفاده از REST API

Watermark REST API و NET SDK

برای افزودن واترمارک متن یا تصویر به فایل‌های DOCX، از .NET SDK از GroupDocs.Watermark Cloud API استفاده خواهم کرد. این امکان را به شما می دهد تا به صورت برنامه ریزی شده، واترمارک ها را از تصاویر و اسناد فرمت های فایل پشتیبانی شده مانند PDF، Microsoft Word و Powerpoint اضافه، حذف، جستجو و جایگزین کنید. علاوه بر این، می توانید با تعیین سبک متن، فونت، اندازه، رنگ یا موقعیت مطابق با نیاز خود، سفارشی سازی واترمارک ها را کنترل کنید. در حال حاضر، جاوا SDK را برای Cloud API نیز ارائه می‌کند.

می‌توانید GroupDocs.Watermark Cloud را از Package Manager NuGet یا با استفاده از دستور زیر در کنسول Package Manager در پروژه Visual Studio خود نصب کنید:

Install-Package GroupDocs.Watermark-Cloud

لطفاً قبل از انجام مراحل ذکر شده، شناسه مشتری و راز خود را از داشبورد دریافت کنید. هنگامی که شناسه و راز خود را دریافت کردید، کد را مطابق شکل زیر اضافه کنید:

string clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
string clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
string myStorage = "";

var configuration = new Configuration(clientId, clientSecret);
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

اضافه کردن واترمارک متنی به اسناد Word با استفاده از REST API در سی شارپ

شما می توانید هر متنی را به عنوان واترمارک به اسناد Word خود به صورت برنامه نویسی با انجام مراحل ساده ذکر شده در زیر اضافه کنید:

• بارگذاری the DOCX file to the Cloud
• افزودن واترمارک متنی به DOCX با استفاده از C#
• دانلود the watermarked file

سند را آپلود کنید

ابتدا سند Word را با استفاده از نمونه کد زیر در Cloud آپلود کنید:

// api را مقداردهی اولیه کنید
var fileApi = new FileApi(configuration);

// باز کردن فایل
var fileStream = File.Open(@"C:\Files\sample.docx", FileMode.Open);

// ایجاد درخواست آپلود فایل
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);

// آپلود فایل
fileApi.UploadFile(request);
fileStream.Close();

در نتیجه، فایل DOCX در فضای ذخیره‌سازی ابری آپلود می‌شود و در بخش فایل‌ها داشبورد شما در دسترس خواهد بود.

اضافه کردن متن واترمارک به DOCX با استفاده از C#

با دنبال کردن مراحل زیر می توانید یک واترمارک متنی را به صورت برنامه ریزی شده به فایل DOCX اضافه کنید.

• یک نمونه از WatermarkApi ایجاد کنید
• یک نمونه از FileInfo ایجاد کنید
• مسیر فایل DOCX را تنظیم کنید
• WatermarkOptions را ایجاد کنید و FileInfo را تنظیم کنید
• TextWatermarkOptions را ایجاد کنید
• متن، خانواده فونت، اندازه قلم و تراز متن را تنظیم کنید
• رنگ پیش زمینه متن واترمارک را تنظیم کنید
• موقعیت واترمارک را تعریف کنید
• WatermarkDetails را تعریف کنید و TextWatermarkOptions و Position را تنظیم کنید
• AddRequest را با WatermarkOptions ایجاد کنید
• با فراخوانی روش WatermarkApi.add() به نتیجه برسید

نمونه کد زیر نحوه اضافه کردن متن به عنوان واترمارک به سند Word را با استفاده از REST API در C# نشان می دهد.

// api را مقداردهی اولیه کنید
var apiInstance = new WatermarkApi(configuration);

// مسیر فایل ورودی
var fileInfo = new FileInfo
{
    FilePath = "sample.docx"
};

// ایجاد گزینه های واترمارک
var options = new WatermarkOptions()
{
    FileInfo = fileInfo,
    
    // تعریف جزئیات واترمارک
    WatermarkDetails = new List<WatermarkDetails>
    {
        new WatermarkDetails
        {
            // تعریف واترمارک متنی
            TextWatermarkOptions = new TextWatermarkOptions
            {
                Text = "Copyright© 2021",
                FontFamilyName = "Arial",
                FontSize = 22d,
                TextAlignment = "Center",
                ForegroundColor = new Color()
                {
                    Name = "Red"
                }
            },

            // تنظیم موقعیت واترمارک
            Position = new Position()
            {
                X = 230.0,
                Y = 500.0
            }
        }
    }
};

// ایجاد درخواست افزودن
var request = new AddRequest(options);

// واترمارک اضافه کنید
var response = apiInstance.Add(request);

Console.WriteLine("Resultant file path: " + response.DownloadUrl);

فایل به روز شده را دانلود کنید

نمونه کد بالا فایل Word را با یک واترمارک متنی در ابر ذخیره می کند. با استفاده از نمونه کد زیر می توانید آن را دانلود کنید:

// api را مقداردهی اولیه کنید
var fileApi = new FileApi(configuration);

// مسیر پیش فرض فایل در فضای ابری
var file = "watermark/added_watermark/sample_docx/sample.docx";

// ایجاد درخواست دانلود فایل
var downloadRequest = new DownloadFileRequest(file, myStorage);

// دریافت فایل
Stream downloadResponse = fileApi.DownloadFile(downloadRequest);

// ذخیره فایل در پوشه کاری
using (var fileStream = System.IO.File.Create("C:\\Files\\DownloadedFile.docx"))
{
    downloadResponse.Seek(0, SeekOrigin.Begin);
    downloadResponse.CopyTo(fileStream);
}

اضافه کردن واترمارک تصویر به اسناد Word با استفاده از REST API

با دنبال کردن مراحل زیر می توانید یک تصویر یا یک لوگو را به عنوان واترمارک به اسناد Word خود به صورت برنامه ریزی شده اضافه کنید.

• یک نمونه از WatermarkApi ایجاد کنید
• یک نمونه از FileInfo ایجاد کنید
• مسیر فایل DOCX را تنظیم کنید
• WatermarkOptions را ایجاد کنید و FileInfo را تنظیم کنید
• ImageWatermarkOptions را ایجاد کنید
• FilePath یک تصویر PNG را با واترمارک تنظیم کنید
• موقعیت واترمارک را تعریف کنید
• ایجاد WatermarkDetails
• ImageWatermarkOptions و Position را تنظیم کنید
• WatermarkDetails را روی List قرار دهید
• AddRequest را با WatermarkOptions ایجاد کنید
• با فراخوانی متد WatermarkApi.add() به نتیجه برسید

نمونه کد زیر نشان می دهد که چگونه می توان یک تصویر را به عنوان واترمارک به DOCX با استفاده از REST API در C# اضافه کرد. لطفاً برای آپلود و دانلود فایل ها مراحل ذکر شده قبلی را دنبال کنید.

// api را مقداردهی اولیه کنید
var apiInstance = new WatermarkApi(configuration);

// مسیر فایل ورودی
var fileInfo = new FileInfo
{
    FilePath = "sample.docx"
};

// ایجاد گزینه های واترمارک
var options = new WatermarkOptions()
{
    FileInfo = fileInfo,
    // جزئیات واترمارک را تعریف کنید
    WatermarkDetails = new List<WatermarkDetails>
    {
        new WatermarkDetails
        {
            // تعریف واترمارک تصویر
            ImageWatermarkOptions = new ImageWatermarkOptions()
            {
                Image = new FileInfo { 
                    FilePath = "logo.png" 
                }
            },

            // تنظیم موقعیت واترمارک
            Position = new Position()
            {
                X = 180.0,
                Y = 280.0
            }
        }
    }
};

// ایجاد درخواست افزودن
var request = new AddRequest(options);

// واترمارک اضافه کنید
var response = apiInstance.Add(request);

Console.WriteLine("Resultant file path: " + response.DownloadUrl);

آنلاین را امتحان کنید

لطفاً ابزار آنلاین رایگان واترمارک زیر را که با استفاده از API بالا ایجاد شده است، امتحان کنید. https://products.groupdocs.app/watermark/docx

نتیجه

در پایان، یاد گرفتید که چگونه متن یا تصویر را به سند Word در ابر اضافه کنید. همچنین یاد گرفته‌اید که چگونه فایل‌های DOCX را به‌صورت برنامه‌نویسی در فضای ابری آپلود کنید و سپس فایل به‌روزرسانی‌شده را از ابر دانلود کنید. می‌توانید درباره GroupDocs.Watermark Cloud API از مستندات اطلاعات بیشتری کسب کنید. ما همچنین یک بخش API Reference ارائه می‌کنیم که به شما امکان می‌دهد APIهای ما را مستقیماً از طریق مرورگر تجسم کرده و با آن‌ها تعامل داشته باشید. در صورت وجود هرگونه ابهام، با [پشتیبانی] تماس بگیرید13.

همچنین ببینید

• با استفاده از REST API، واترمارک ها را در اسناد پیدا و جایگزین کنید
• Watermark Cloud API & SDKs برای ایمن کردن اسناد