Configurazione di un File di Licenza per Sheetize

Obiettivo: Caricare un file di licenza valido in modo che la libreria Sheetize NuGet/DLL sblocchi tutte le funzionalità premium.
I passaggi seguenti funzionano per qualsiasi linguaggio .NET (C#, VB.NET, C++, F#, ecc.) e per progetti che riferiscono Sheetize tramite NuGet o aggiungendo direttamente il .dll compilato.

1 – Ottieni il tuo File di Licenza

Origine	Come Ottenerlo
Pagina di acquisto	Scarica `Sheetize.*.lic` dopo il checkout.

Importante: Posiziona il file in una cartella sola lettura che venga inclusa nella distribuzione, oppure in una cartella sicura accanto all’eseguibile. Non aggiungere il file di licenza a un repository pubblico per evitare usi non autorizzati.

2 – Aggiungi il File di Licenza al Progetto (opzionale)

IDE / Sistema di Build	Passaggi
Visual Studio (qualunque progetto .NET)	1. Fai clic destro sul progetto → Aggiungi → Elemento esistente e seleziona `Sheetize.(*).lic`.
2. Imposta Azione di compilazione su Content.
3. Imposta Copia nella directory di output su Copia se più recente (oppure Copia sempre).

Suggerimento: Se hai più ambienti (dev, test, prod) puoi mantenere un file di licenza separato per ciascuna cartella (licenses/dev/, licenses/prod/) e copiare quello corretto durante la build usando un attributo Condition.

3 – Inizializza Sheetize con il File di Licenza

La libreria Sheetize richiede di chiamare LicenseManager.Load(string path) una sola volta prima di utilizzare qualsiasi altra API di Sheetize. Di seguito trovi gli snippet per diversi linguaggi.

C# (il più comune)

using Sheetize; // Namespace della libreria
using System;
using System.IO;

public static class Program
{
    private static void Main()
    {
        // Il percorso è relativo alla cartella dell'eseguibile (dove il file è stato copiato)
        string licensePath = "/path/to/Sheetize.PdfConverter_for_.NET.lic";
        License license = new Sheetize.License();
        license.SetLicense(licensePath);

        // Ora puoi usare le funzionalità premium
        var loadOptions = new LoadOptions
        {
            InputFile = "/path/to/sample.xlsx"
        };
        var saveOptions = new SpreadsheetSaveOptions
        {
            OutputFile = "/path/to/sample.pdf"
        };
        SpreadsheetConverter.Process(loadOptions, saveOptions);
        // .
    }
}

4 – Verifica la Licenza a Runtime

Un modo comune per verificare il corretto caricamento della licenza è controllare che il file di output non contenga il watermark. Se la licenza è stata letta correttamente, il watermark non verrà mostrato.

Sei Pronto!

Aggiungi il file Sheetize.*.lic al progetto e impostalo per la copia nella cartella di output.
Chiama SetLicense(...) prima di qualsiasi utilizzo di Sheetize.
Distribuisci il file di licenza insieme ai tuoi binary (o tramite un mount sicuro).

Una volta completati questi passaggi, tutte le funzionalità a pagamento di Sheetize – grafici avanzati, streaming ad alte prestazioni, crittografia multi-foglio, ecc. – saranno completamente sbloccate per i tuoi utenti, indipendentemente dal linguaggio .NET (C#, VB.NET, C++/CLI o altro).

Buon coding!

(*) Questo testo può variare a seconda dell’edizione.