Lisensi Aspose PDF

Batasan versi evaluasi

Kami ingin pelanggan kami menguji komponen kami secara menyeluruh sebelum membeli, jadi versi evaluasi memungkinkan Anda menggunakannya seperti biasanya.

  • PDF yang dibuat dengan watermark evaluasi. Versi evaluasi dari Aspose.PDF for .NET menyediakan fungsionalitas produk penuh, tetapi semua halaman dalam dokumen PDF yang dihasilkan diberi watermark dengan teks “Hanya Evaluasi. Dibuat dengan Aspose.PDF. Hak Cipta 2002-2025 Aspose Pty Ltd.” di bagian atas.

  • Batasi jumlah halaman yang dapat diproses. Dalam versi evaluasi, Anda hanya dapat memproses empat halaman pertama dari sebuah dokumen.

Jika Anda ingin menguji Aspose.PDF for .NET tanpa batasan versi evaluasi, Anda juga dapat meminta Lisensi Sementara selama 30 hari. Silakan merujuk ke Bagaimana cara mendapatkan Lisensi Sementara?

Lisensi Classic

Lisensi dapat dimuat dari file atau objek stream. Cara termudah untuk mengatur lisensi adalah dengan menempatkan file lisensi di folder yang sama dengan file Aspose.PDF.dll dan menentukan nama file tanpa jalur, seperti yang ditunjukkan dalam contoh di bawah ini.

Jika Anda menggunakan komponen Aspose untuk .NET lainnya bersama dengan Aspose.PDF for .NET, silakan tentukan namespace untuk Lisensi seperti Aspose.Pdf.License.

Memuat lisensi dari file

Cara termudah untuk menerapkan lisensi adalah dengan menempatkan file lisensi di folder yang sama dengan file Aspose.PDF.dll dan hanya menentukan nama file tanpa jalur.

Ketika Anda memanggil metode SetLicense, nama lisensi yang Anda berikan harus sesuai dengan nama file lisensi Anda. Misalnya, jika Anda mengubah nama file lisensi menjadi “Aspose.PDF.lic.xml”, berikan nama file itu ke metode Pdf.SetLicense(…) .

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SetLicenseExample()
{
    // Initialize license object
    var license = new Aspose.Pdf.License();
    try
    {
        // Set license
        license.SetLicense("Aspose.Pdf.lic");
    }
    catch (Exception)
    {
        // Something went wrong
        throw;
    }
    Console.WriteLine("License set successfully.");
}

Memuat lisensi dari objek stream

Contoh berikut menunjukkan cara memuat lisensi dari stream.

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SetLicenseFromStream()
{
    // Initialize license object
    var license = new Aspose.Pdf.License();
    // Load license from the file stream
    var myStream = new FileStream(
            "Aspose.Pdf.lic",
            FileMode.Open);
    // Set license
    license.SetLicense(myStream);
    Console.WriteLine("License set successfully.");
}

Lisensi Metered

Aspose.PDF memungkinkan pengembang untuk menerapkan kunci metered. Mekanisme lisensi metered akan digunakan bersama dengan metode lisensi yang ada. Pelanggan yang ingin ditagih berdasarkan penggunaan fitur API dapat menggunakan lisensi metered. Untuk detail lebih lanjut, silakan merujuk ke bagian FAQ Lisensi Metered. Panduan ini memberikan praktik terbaik untuk implementasi yang lancar dan mencegah gangguan akibat perubahan status lisensi.

Kelas “Metered” digunakan untuk menerapkan kunci metered. Berikut adalah contoh kode yang menunjukkan cara mengatur kunci publik dan privat metered.

Untuk detail lebih lanjut, silakan merujuk ke bagian FAQ Lisensi Metered.

Metode Lisensi Metered

Menerapkan Lisensi Metered menggunakan metode SetMeteredKey untuk mengaktifkan lisensi metered dengan memberikan kunci publik dan privat Anda. Ini harus dilakukan sekali selama inisialisasi aplikasi untuk memastikan lisensi yang tepat.

Contoh:

 var metered = new Aspose.Pdf.Metered();
 metered.SetMeteredKey("your-public-key", "your-private-key");

Memeriksa Status Lisensi menggunakan IsMeteredLicensed() untuk memverifikasi apakah lisensi metered aktif.

Contoh:

bool isLicensed = Aspose.Pdf.License.IsMeteredLicensed();
if (!isLicensed) 
{
    metered.SetMeteredKey("your-public-key", "your-private-key");
}

Metode Metered.GetConsumptionCredit() digunakan untuk mendapatkan informasi tentang kredit konsumsi. Metode Metered.GetConsumptionQuantity() digunakan untuk mendapatkan informasi tentang ukuran file konsumsi.

Contoh:

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SetMeteredLicense()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();
    // Set metered public and private keys
    var metered = new Aspose.Pdf.Metered();
    // Access the setMeteredKey property and pass public and private keys as parameters
    metered.SetMeteredKey("your public key", "your private key");

    // Open PDF document
    using (var document = new Aspose.Pdf.Document(dataDir + "input.pdf"))
    {
       // Add five pages
       AddPages(document, 5);
       // Save the document
       document.Save(dataDir + "output.pdf")
    }
}

private static void AddPages(Document document, int n)
{
    for(int i = 0; i < n; i++)
    {
        document.Pages.Add();
    }
}

Praktik Terbaik untuk Lisensi Metered

✅ Pendekatan yang Direkomendasikan: Pola Singleton Untuk memastikan pengaturan lisensi yang stabil:

  • Terapkan lisensi sekali saat aplikasi dimulai.
  • Gunakan pola singleton (atau pendekatan serupa) untuk membuat dan menggunakan kembali instance lisensi metered.
  • Periksa status lisensi secara berkala menggunakan IsMeteredLicensed(). Terapkan kembali lisensi hanya jika menjadi tidak valid.
  • Jika diterapkan dengan benar, lisensi tetap valid selama 24 jam bahkan jika server lisensi tidak tersedia sementara.

Contoh: Implementasi Singleton

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
public class AsposeLicenseManager
{
    private static AsposeLicenseManager _instance;
    private static readonly object _lock = new object();
    private Aspose.Pdf.Metered _metered;

    private AsposeLicenseManager()
    {
        _metered = new Aspose.Pdf.Metered();
        _metered.SetMeteredKey("your-public-key", "your-private-key");
    }

    public static AsposeLicenseManager Instance
    {
        get
        {
            lock (_lock)
            {
                if (_instance == null)
                {
                    _instance = new AsposeLicenseManager();
                }
                return _instance;
            }
        }
    }

    public void ValidateLicense()
    {
        if (!Aspose.Pdf.License.IsMeteredLicensed())
        {
        _metered.SetMeteredKey("your-public-key", "your-private-key");
        }
    }
}

❌ Kesalahan Umum yang Harus Dihindari:

  • Aplikasi Lisensi yang Sering
  • Jangan membuat instance lisensi metered baru untuk setiap operasi.
  • Jika server lisensi tidak dapat dijangkau selama inisialisasi, lisensi dapat kembali ke mode evaluasi.
  • Jangan menerapkan lisensi berulang kali untuk setiap operasi.
  • Aplikasi lisensi yang sering dapat menyebabkan fallback ke mode percobaan jika server lisensi tidak tersedia sementara.

Ringkasan:

✅ Atur lisensi metered sekali saat aplikasi dimulai. ✅ Gunakan pola singleton untuk mengelola satu instance. ✅ Periksa dan terapkan kembali lisensi secara berkala jika diperlukan. ❌ Hindari aplikasi lisensi yang sering untuk mencegah fallback ke mode percobaan. Dengan mengikuti praktik terbaik ini, Anda memastikan penggunaan Aspose.PDF yang lancar dan tidak terputus dengan lisensi metered.

Jika lisensi telah diinisialisasi, maka selama objek ini “hidup”, bahkan jika koneksi ke server lisensi hilang karena alasan tertentu, lisensi akan dianggap aktif selama 7 hari lagi. Jika Anda menginisialisasi lisensi setiap kali Anda perlu melakukan sesuatu dan tidak ada koneksi ke server pada saat inisialisasi, maka lisensi akan masuk ke mode Eval. Perlu ditekankan lebih lanjut bahwa jika seorang pengguna telah menginisialisasi lisensi, maka selama objek ini “hidup”, bahkan jika koneksi ke server lisensi hilang karena alasan tertentu, lisensi akan dianggap aktif selama 24 jam lagi. Jika Anda menginisialisasi lisensi setiap kali Anda perlu melakukan sesuatu dan tidak ada koneksi ke server pada saat inisialisasi, maka lisensi akan masuk ke mode Eval.

Harap dicatat bahwa aplikasi COM yang bekerja dengan Aspose.PDF for .NET juga harus menggunakan kelas Lisensi.

Satu poin yang perlu dipertimbangkan: Harap dicatat bahwa sumber daya yang disematkan disertakan dalam assembly seperti yang ditambahkan, yaitu jika Anda menambahkan file teks sebagai sumber daya yang disematkan dalam aplikasi dan membuka EXE yang dihasilkan di notepad, Anda akan melihat isi file teks yang tepat. Jadi saat menggunakan file lisensi sebagai sumber daya yang disematkan, siapa pun dapat membuka file exe di beberapa editor teks sederhana dan melihat/mengambil isi lisensi yang disematkan.

Oleh karena itu, untuk menambahkan lapisan keamanan ekstra saat menyematkan lisensi dengan aplikasi, Anda dapat mengompres/mengenskripsi lisensi dan setelah itu, Anda dapat menyematkannya ke dalam assembly. Misalkan kita memiliki file lisensi Aspose.PDF.lic, jadi mari kita buat Aspose.PDF.zip dengan kata sandi test dan sematkan file zip ini ke dalam solusi. Potongan kode berikut dapat digunakan untuk menginisialisasi lisensi:

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SetLicenseFromStream()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();
    var license = new Aspose.Pdf.License();
    license.SetLicense(GetSecureLicenseFromStream());
    // Open PDF document
    using (var document = new Aspose.Pdf.Document(dataDir + "input.pdf"))
    {
        // Get the page count of document
        Console.WriteLine(document.Pages.Count);
    }
}

private static Stream GetSecureLicenseFromStream()
{
    var assembly = Assembly.GetExecutingAssembly();
    var memoryStream = new MemoryStream();
    using (var zipToOpen = assembly.GetManifestResourceStream("Aspose.Pdf.Examples.License.Aspose.PDF.zip"))
    {
        using (ZipArchive archive = new ZipArchive(zipToOpen ?? throw new InvalidOperationException(), ZipArchiveMode.Read))
        {
            var unpackedLicense  = archive.GetEntry("Aspose.PDF.lic");
            unpackedLicense?.Open().CopyTo(memoryStream);
        }
    }

    memoryStream.Position = 0;
    return memoryStream;
}
Fitur Utama Aspose.PDF Aspose.PDF for .NET Dukungan