Setup License

Einrichtung einer Lizenzdatei für Sheetize

Ziel: Laden einer gültigen Lizenzdatei, damit die Sheetize‑NuGet/DLL‑Bibliothek alle Premium‑Funktionen freischaltet.
Die unten beschriebenen Schritte funktionieren für jede .NET‑Sprache (C#, VB.NET, C++, F# usw.) und für Projekte, die Sheetize entweder über NuGet oder durch direktes Hinzufügen der kompilierten .dll referenzieren.


1 – Lizenzdatei beschaffen

Quelle Wie man sie erhält
Die Kaufseite Laden Sie Sheetize.*.lic nach dem Checkout herunter.

Wichtig: Bewahren Sie die Datei an einem schreibgeschützten Ort auf, der in Ihre Bereitstellung einbezogen wird, oder in einem sicheren Ordner neben der ausführbaren Datei. Committen Sie die Lizenzdatei nicht in ein öffentliches Quellcode‑Repository, um Missbrauch zu vermeiden.


2 – Lizenzdatei zum Projekt hinzufügen (optional)

IDE / Buildsystem Schritte
Visual Studio (beliebiges .NET‑Projekt) 1. Rechtsklick auf das Projekt → Hinzufügen → Vorhandenes ElementSheetize.(*).lic auswählen.
2. Build Action auf Content setzen.
3. Copy to Output Directory auf Copy if newer (oder Copy always) setzen.

Tipp: Wenn Sie mehrere Umgebungen (Entwicklung, Test, Produktion) haben, können Sie je einen separaten Lizenzordner führen (licenses/dev/, licenses/prod/) und die passende Datei zur Build‑Zeit per Condition‑Attribut kopieren.


3 – Sheetize mit der Lizenzdatei initialisieren

Die Sheetize‑Bibliothek erwartet, dass Sie LicenseManager.Load(string path) einmal aufrufen, bevor Sie irgendeine andere Sheetize‑API verwenden. Nachfolgend language‑spezifische Schnipsel.

C# (am häufigsten)

using Sheetize; // Namespace der Bibliothek
using System;
using System.IO;

public static class Program
{
    private static void Main()
    {
        // Pfad ist relativ zum Ordner der laufenden EXE (wo die Datei kopiert wurde)
        string licensePath = "/path/to/Sheetize.PdfConverter_for_.NET.lic";
        License license = new Sheetize.License();
        license.SetLicense(licensePath);

        // Jetzt können Sie Premium‑Funktionen nutzen
        var loadOptions = new LoadOptions
        {
            InputFile = "/path/to/sample.xlsx"
        };
        var saveOptions = new SpreadsheetSaveOptions
        {
            OutputFile = "/path/to/sample.pdf"
        };
        SpreadsheetConverter.Process(loadOptions, saveOptions);
        // .
    }
}

4 – Lizenz zur Laufzeit prüfen

Ein verbreitetes Muster ist, zu prüfen, ob die Ausgabedatei ohne Wasserzeichen erscheint. Wenn die Lizenzdatei korrekt geladen wurde, wird das Wasserzeichen nicht mehr angezeigt.


Sie sind fertig!

  1. Fügen Sie die Datei Sheetize.*.lic Ihrem Projekt hinzu und markieren Sie sie, damit sie in das Ausgabeverzeichnis kopiert wird.
  2. Rufen Sie SetLicense(...) vor jeglicher Nutzung von Sheetize auf.
  3. Stellen Sie die Lizenzdatei zusammen mit Ihren Binärdateien (oder über ein sicheres Mount) bereit.

Sobald diese Schritte erledigt sind, werden alle bezahlten Sheetize‑Funktionen – erweiterte Diagramme, Hochleistungs‑Streaming, Multi‑Sheet‑Verschlüsselung usw. – für Ihre Benutzer vollständig freigeschaltet, unabhängig davon, ob sie in C#, VB.NET, C++/CLI oder einer anderen .NET‑unterstützten Sprache programmieren.

Viel Spaß beim Programmieren!

(*) Dieser Text hängt von der Edition ab.