تنظیم یک فایل لایسنس برای Sheetize

هدف: بارگذاری یک فایل لایسنس معتبر تا کتابخانه Sheetize NuGet/DLL تمام امکانات پرمیوم را فعال کند.
مراحل زیر برای هر زبان .NET (C#، VB.NET، C++، F# و غیره) و برای پروژه‌هایی که Sheetize را از طریق NuGet یا اضافه کردن مستقیم .dll استفاده می‌کنند، کار می‌کند.

۱‑ دریافت فایل لایسنس خود

منبع	نحوه دریافت
صفحه خرید	پس از پرداخت، فایل `Sheetize.*.lic` را دانلود کنید.

مهم: فایل را در مکان فقط‑خواندنی که در استقرار (deployment) گنجانده می‌شود یا در پوشه‌ای امن کنار اجرایی نگهداری کنید. از قرار دادن فایل لایسنس در مخازن عمومی کد برای جلوگیری از سوءاستفاده خودداری کنید.

۲‑ اضافه کردن فایل لایسنس به پروژه (اختیاری)

IDE / سیستم ساخت	مراحل
Visual Studio (هر پروژه .NET)	1️⃣ کلیک راست روی پروژه → Add → Existing Item → فایل `Sheetize.(*).lic` را انتخاب کنید.
2️⃣ Build Action را روی Content تنظیم کنید.
3️⃣ Copy to Output Directory را روی Copy if newer (یا Copy always) تنظیم کنید.

نکته: اگر برای محیط‌های مختلف (dev، test، prod) لایسنس‌های جداگانه دارید، می‌توانید پوشه‌های licenses/dev/، licenses/prod/ و … داشته باشید و در زمان ساخت با استفاده از ویژگی Condition، فایل مناسب را کپی کنید.

۳‑ مقداردهی اولیه Sheetize با فایل لایسنس

کتابخانه Sheetize انتظار دارد متد LicenseManager.Load(string path) یک بار قبل از استفاده از هر API دیگر فراخوانی شود. در ادامه نمونه‌های کد برای زبان‌های مختلف آورده شده است.

C# (پرکاربردترین)

using Sheetize; // فضای نام کتابخانه
using System;
using System.IO;

public static class Program
{
    private static void Main()
    {
        // مسیر نسبی به پوشه‌ی اجرایی (جایی که فایل کپی شده است)
        string licensePath = "/path/to/Sheetize.PdfConverter_for_.NET.lic";
        License license = new Sheetize.License();
        license.SetLicense(licensePath);

        // حال می‌توانید از قابلیت‌های پیشرفته استفاده کنید
        var loadOptions = new LoadOptions
        {
            InputFile = "/path/to/sample.xlsx"
        };
        var saveOptions = new SpreadsheetSaveOptions
        {
            OutputFile = "/path/to/sample.pdf"
        };
        SpreadsheetConverter.Process(loadOptions, saveOptions);
        // .
    }
}

۴‑ تأیید لایسنس در زمان اجرا

یک روش متداول بررسی این است که خروجی تولیدی آب‌نشان (watermark) نداشته باشد. یعنی اگر لایسنس به‌درستی خوانده شود، آب‌نشان نمایش داده نخواهد شد.

آماده‌اید!

فایل Sheetize.*.lic را به پروژه اضافه کنید و آن را برای کپی به پوشه خروجی تنظیم کنید.
قبل از استفاده از هر API Sheetize، SetLicense(...) را صدا بزنید.
فایل لایسنس را همراه با باینری‌ها (یا از طریق یک mount امن) استقرار دهید.

پس از انجام این مراحل، تمام قابلیت‌های پولی Sheetize—نمودارهای پیشرفته، پردازش با کارایی بالا، رمزنگاری چند شیت و غیره—به‌طور کامل برای کاربران شما فعال می‌شود، چه در C#، VB.NET، C++/CLI یا هر زبان دیگر مبتنی بر .NET برنامه‌نویسی کنید.

کد نویسی خوش!

(*) این متن بسته به نوع نسخه (edition) ممکن است متفاوت باشد.