اضافه کردن واترمارک به برگه اکسل با استفاده از سی شارپ

ما قبلاً راه‌هایی برای واترمارک کردن اسناد، تصاویر و ارائه‌ها بحث کرده‌ایم. امروز، ما در مورد نحوه افزودن واترمارک به یک کتاب کار اکسل به روش های مختلف با استفاده از C# با برنامه .NET بحث خواهیم کرد.

موضوعات زیر در زیر پوشش داده شده است:

NET API برای واترمارک برگه های اکسل

GroupDocs.Watermark .NET API را برای اسناد و تصاویر با فرمت های مختلف فایل ارائه می کند. ما از GroupDocs.Watermark for .NET برای اعمال واترمارک در صفحات گسترده به روش های مختلف با استفاده از C# استفاده خواهیم کرد.

می‌توانید نصب‌کننده DLL یا MSI را از بخش دانلودها دانلود کنید یا آن را از NuGet دریافت کنید.

Install-Package GroupDocs.Watermark

واترمارک برگه های اکسل با استفاده از C#

API به شما امکان می دهد متن را به عنوان واترمارک با سفارشی سازی های مختلف در صفحات گسترده وارد کنید. مراحل زیر برای افزودن واترمارک به کتاب‌های کار اکسل با استفاده از C# با برنامه‌های NET ارائه شده است.

  • گزینه های بارگیری را برای صفحه گسترده آماده کنید.
  • صفحه گسترده را با استفاده از Watermarker بارگیری کنید.
  • متن و ظاهر واترمارک را با استفاده از TextWatermark تعریف کنید.
  • با استفاده از روش Add، واترمارک متن را به کاربرگ اکسل اضافه کنید.
  • با استفاده از روش Save صفحه گسترده حاصل را با واترمارک ذخیره کنید.

نمونه کد C# زیر واترمارک متنی را با چرخش و کدورت بر روی تمام برگه های کتاب کار اکسل اعمال می کند.

/*
 * اضافه کردن واترمارک به تمام برگه های کتاب کار اکسل با استفاده از C#
 */
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
using (Watermarker watermarker = new Watermarker(@"path/spreadsheet.xlsx", loadOptions))
{
    // اضافه کردن واترمارک متنی به کاربرگ
    TextWatermark textWatermark = new TextWatermark("DRAFT", new Font("Arial", 100))
    {
        RotateAngle = -45,
        Height = 200,
        Width = 500,
        Opacity = .2,
        ForegroundColor = Color.DarkBlue
    };
    // واترمارک اضافه کنید و صفحه گسترده واترمارک شده را ذخیره کنید.
    watermarker.Add(textWatermark);
    watermarker.Save(@"path/allpages-watermark-spreadsheet.xlsx");
}

برگه اکسل خاص واترمارک با استفاده از C#

به طور مشابه، می‌توانید به جای اعمال واترمارک در تمام برگه‌های کتاب کار، فقط روی هر برگه خاصی اعمال کنید. راهنمای مراحل زیر در مورد نحوه درج واترمارک متنی به برگه خاص کتاب کار اکسل با استفاده از C#.

  • گزینه های بارگیری را آماده کنید.
  • صفحه گسترده را با استفاده از کلاس Watermarker بارگیری کنید.
  • ظاهر واترمارک و متن را با استفاده از کلاس TextWatermark تعریف کنید.
  • ایندکس کاربرگ را طوری تنظیم کنید که واترمارک فقط روی برگه ذکر شده اعمال شود.
  • با استفاده از روش Add با گزینه های واترمارک، واترمارک متن را به کاربرگ اکسل اضافه کنید.
  • صفحه گسترده خروجی را با واترمارک با استفاده از روش Save ذخیره کنید.

قطعه کد زیر واترمارک متنی را فقط برای برگه ذکر شده کتاب کار اکسل اعمال می کند.

/*
 * اضافه کردن واترمارک فقط به برگه ذکر شده از Workbook Excel با استفاده از C#
 */
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
using (Watermarker watermarker = new Watermarker(@"path/spreadsheet.xlsx", loadOptions))
{
    // اضافه کردن واترمارک متنی به کاربرگ
    TextWatermark textWatermark = new TextWatermark("DRAFT", new Font("Arial", 100))
    {
        RotateAngle = -45,
        Height = 200,
        Width = 500,
        Opacity = .2,
        ForegroundColor = Color.DarkBlue
    };
    // شاخص کاربرگ را تعریف کنید
    SpreadsheetWatermarkShapeOptions textWatermarkOptions = new SpreadsheetWatermarkShapeOptions()
    {
        WorksheetIndex = 1
    };
    // واترمارک اضافه کنید و صفحه گسترده واترمارک شده را ذخیره کنید.    
    watermarker.Add(textWatermark, textWatermarkOptions);
    watermarker.Save(@"path/onepage-watermark-spreadsheet.xlsx");
}

واترمارک برگه های اکسل به عنوان پس زمینه با استفاده از C#

به همین ترتیب، ما همچنین می توانیم واترمارک را به عنوان پس زمینه صفحه گسترده اضافه کنیم. تغییر کمی نسبت به تکنیک های بالا برای اعمال واترمارک ایجاد خواهد شد. مراحل زیر امکان درج واترمارک متن پس‌زمینه را با استفاده از C# در صفحه‌گسترده اکسل می‌دهد.

  • گزینه های بارگیری را برای بارگیری صفحه گسترده آماده کنید.
  • صفحه گسترده را با استفاده از Watermarker بارگیری کنید.
  • متن واترمارک و ظاهر (چرخش، موقعیت، ابعاد، کدورت، رنگ و موارد دیگر) را با استفاده از TextWatermark تعریف کنید.
  • با دریافت محتوا و تنظیم ابعاد، گزینه های واترمارک پس زمینه را تنظیم کنید.
  • شاخص کاربرگ را برای اعمال واترمارک تنظیم کنید. (اختیاری)
  • با استفاده از روش Add، واترمارک را به صفحه گسترده اضافه کنید.
  • با استفاده از روش Save صفحه گسترده را با واترمارک ذخیره کنید.

نمونه کد زیر نحوه افزودن واترمارک پس‌زمینه به صفحه‌گسترده اکسل را با استفاده از C# در برنامه دات‌نت نشان می‌دهد.

/*
 * اضافه کردن واترمارک به عنوان پس زمینه به کتاب کار اکسل با استفاده از سی شارپ
 */
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
using (Watermarker watermarker = new Watermarker(@"path/spreadsheet.xlsx", loadOptions))
{
    // ظاهر واترمارک را تعریف کنید
    TextWatermark textWatermark = new TextWatermark("DRAFT", new Font("Arial", 100))
    {
        RotateAngle = -45,
        X = 200,
        Y = 200,
        Height = 200,
        Width = 500,
        Opacity = .2,
        ForegroundColor = Color.DarkBlue
    };
    // ابعاد محتوای صفحه گسترده را دریافت کنید
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    SpreadsheetBackgroundWatermarkOptions options = new SpreadsheetBackgroundWatermarkOptions();
    options.BackgroundWidth = content.Worksheets[0].ContentAreaWidthPx; /* set background width */
    options.BackgroundHeight = content.Worksheets[0].ContentAreaHeightPx; /* set background height */
    options.WorksheetIndex = 0;

    // واترمارک اضافه کنید و صفحه گسترده واترمارک شده را ذخیره کنید.
    watermarker.Add(textWatermark, options);
    watermarker.Save(@"path/background-watermark-spreadsheet.xlsx");
}
واترمارک برگه های اکسل به صورت برنامه ریزی شده

مجوز API رایگان دریافت کنید

برای استفاده از API بدون محدودیت ارزیابی، می توانید یک مجوز موقت رایگان دریافت کنید.

نتیجه

به طور خلاصه، روش‌های مختلفی برای افزودن واترمارک به برگه‌های اکسل با استفاده از C# را مورد بحث قرار دادیم. ابتدا واترمارک متنی را به تمام برگه های کتاب کار اکسل اضافه کردیم. سپس واترمارک را فقط روی برگه خاص اعمال کردیم. در نهایت، ما واترمارک مبتنی بر متن را به عنوان پس‌زمینه در کتاب کار اکسل قرار دادیم.

برای کسب اطلاعات بیشتر در مورد API، از محصول مستندات دیدن کنید. برای سؤالات، از طریق [فروم 29 با ما تماس بگیرید.

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