Cara membuat pratinjau di .NET menggunakan GroupDocs.Annotation

Membuat pengalaman cara membuat pratinjau merupakan fondasi aplikasi modern yang berfokus pada dokumen. Dengan GroupDocs.Annotation untuk .NET Anda dapat merender gambar miniatur PDF, menghasilkan aliran pratinjau dokumen yang aman, dan menjaga antarmuka pengguna tetap responsif bahkan pada perangkat seluler. Dalam panduan ini Anda akan menemukan mengapa pembuatan pratinjau penting, menjelajahi skenario implementasi umum, dan mendapatkan peta jalan untuk menambahkan pratinjau berkualitas tinggi ke solusi Anda.

Jawaban cepat

Kelas AnnotationApi adalah komponen inti GroupDocs.Annotation yang memuat dokumen dan membuat gambar pratinjau. Metode GetPages mengembalikan gambar halaman yang dirender sebagai array byte. Flag HideAnnotations menghapus semua lapisan anotasi dari gambar yang dirender.

  • Apa cara tercepat untuk merender thumbnail PDF? Muat PDF dengan AnnotationApi, atur DPI = 150, dan panggil GetPages – halaman pertama dikembalikan sebagai PNG dalam waktu kurang dari 200 ms untuk file 2 MB.
  • Apakah saya dapat menyembunyikan semua anotasi dalam pratinjau? Ya – gunakan flag HideAnnotations sebelum merender untuk menghasilkan tampilan bersih.
  • Apakah pembuatan pratinjau thread‑safe? API bersifat stateless; Anda dapat menjalankan beberapa tugas pratinjau secara paralel dengan aman.
  • Apakah saya memerlukan lisensi untuk penggunaan produksi? Lisensi GroupDocs.Annotation yang valid diperlukan untuk pembuatan pratinjau tanpa batas.
  • Versi .NET apa yang didukung? .NET Framework 4.6+, .NET Core 3.1+, .NET 5/6/7.

Apa itu pratinjau dokumen?

Pratinjau dokumen adalah representasi visual ringan dari sebuah file—biasanya berupa gambar atau serangkaian gambar—yang memungkinkan pengguna melihat sekilas isi tanpa mengunduh dokumen lengkap. Ini meningkatkan UX, mengurangi bandwidth, dan menambahkan lapisan keamanan dengan hanya menampilkan apa yang Anda putuskan untuk dirender.

Mengapa menggunakan pratinjau dokumen yang aman?

Pratinjau dokumen yang aman memastikan bahwa metadata sensitif, lapisan tersembunyi, atau anotasi terbatas tidak pernah keluar dari server. GroupDocs.Annotation mengenkripsi aliran pratinjau dan menghapus semua markup yang tidak secara eksplisit Anda izinkan, memberi Anda kontrol penuh atas apa yang dilihat pengguna akhir. Klaim terukur: perpustakaan ini mendukung lebih dari 30 format file dan dapat menghasilkan pratinjau untuk PDF 500‑halaman dalam waktu kurang dari 2 detik pada server standar 8‑core saat menggunakan DPI default 150.

Bagaimana cara merender thumbnail PDF?

Muat PDF dengan AnnotationApi, tentukan DPI 150‑300 untuk teks yang tajam, dan minta halaman pertama sebagai PNG. Pendekatan dua langkah ini mengembalikan array byte yang dapat Anda alirkan langsung ke browser atau simpan di disk. Menggunakan DPI lebih tinggi (mis., 300) meningkatkan keterbacaan untuk dokumen dengan banyak teks, sementara DPI lebih rendah (mis., 72) mengurangi ukuran file untuk grid thumbnail.

Prasyarat

  • .NET Framework 4.6+ atau .NET Core 3.1+ terinstal.
  • Lisensi GroupDocs.Annotation yang valid (lisensi sementara dapat digunakan untuk evaluasi).
  • Akses ke file PDF, Word, Excel, atau file lain yang didukung yang ingin Anda pratinjau.

Cara membuat pratinjau langkah demi langkah

Untuk membuat pratinjau Anda perlu menginstal paket GroupDocs.Annotation, menginisialisasi API dengan lisensi Anda, mengonfigurasi opsi pratinjau, menghasilkan gambar, dan secara opsional menyimpan hasilnya dalam cache. Bagian-bagian berikut menjelaskan setiap langkah dengan contoh kode, menunjukkan cara menyembunyikan anotasi, mengatur DPI, dan menangani file besar secara efisien.

Langkah 1: instal paket NuGet

Open your project’s Package Manager Console and run:

Install-Package GroupDocs.Annotation

Langkah 2: inisialisasi API

Create an AnnotationApi instance, passing your license file path and optional configuration (e.g., cache folder, memory limit).

var config = new AnnotationConfig
{
    LicensePath = "GroupDocs.Annotation.lic",
    CacheFolder = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "Cache")
};
var annotationApi = new AnnotationApi(config);

Langkah 3: buat pratinjau tanpa anotasi

Set the HideAnnotations flag to true, choose the desired DPI, and request the page(s) you need.

var previewOptions = new PreviewOptions
{
    HideAnnotations = true,
    Dpi = 150,
    OutputFormat = PreviewOutputFormat.Png,
    PageNumbers = new[] { 1 }   // first page only for thumbnail
};

byte[] previewBytes = annotationApi.GetPreview("sample.pdf", previewOptions);
File.WriteAllBytes("sample_thumb.png", previewBytes);

Pemanggilan GetPreview mengembalikan array byte yang dapat Anda kirim langsung ke respons HTTP, menyimpannya di CDN, atau menyematkannya dalam komponen UI.

Langkah 4: cache dan gunakan kembali pratinjau

Untuk menghindari pembuatan ulang pratinjau yang sama berulang kali, simpan gambar menggunakan hash dari file sumber dan pengaturan pratinjau sebagai kunci cache. Ketika dokumen sumber berubah, invalidasi cache dengan membandingkan cap waktu.

string cacheKey = $"{Path.GetFileNameWithoutExtension(filePath)}_{previewOptions.Dpi}_{previewOptions.HideAnnotations}";

Langkah 5: tangani dokumen besar secara efisien

Untuk file yang lebih besar dari 100 MB, gunakan blok using untuk memastikan AnnotationApi membuang aliran internal dengan cepat. Proses halaman dalam batch jika Anda memerlukan pratinjau multi‑halaman, melepaskan setiap batch sebelum beralih ke berikutnya.

Skenario implementasi umum

  • Sistem manajemen dokumen – menampilkan grid gambar miniatur untuk navigasi visual cepat.
  • Platform kolaborasi – merender tampilan hanya pratinjau untuk peninjau, kemudian memungkinkan lapisan anotasi diaktifkan sesuai permintaan.
  • Portal web – menampilkan pratinjau saat mengarahkan kursor pada tautan file, mengurangi kebutuhan mengunduh penuh.
  • Aplikasi seluler – menghasilkan PNG beresolusi rendah (72 DPI) untuk menjaga penggunaan bandwidth di bawah 50 KB per halaman.

Pemecahan masalah pembuatan pratinjau

  • Lonjakan memori dengan PDF besar – pastikan memanggil Dispose() pada AnnotationApi setelah setiap batch pratinjau, dan batasi jumlah tugas pratinjau yang berjalan secara bersamaan.
  • Teks buram pada thumbnail – tingkatkan DPI menjadi 300 atau ubah format output ke PNG; kompresi JPEG dapat membuat karakter tipis menjadi lembut.
  • Gambar hilang pada pratinjau Excel – pastikan objek diagram workbook dimuat sepenuhnya dengan mengatur LoadCharts = true dalam opsi pratinjau.
  • Waktu respons lambat – pindahkan pembuatan pratinjau ke pekerja latar belakang (mis., Task.Run) dan sajikan gambar placeholder hingga pratinjau sebenarnya siap.

Pertanyaan yang sering diajukan

T: Bisakah saya menghasilkan pratinjau untuk dokumen yang dilindungi kata sandi?
J: Ya. Berikan kata sandi dalam LoadOptions saat membuat instance AnnotationApi; pratinjau akan dihasilkan setelah dekripsi berhasil.

T: Apakah perpustakaan ini mendukung rendering pratinjau untuk format non‑PDF seperti DOCX atau XLSX?
J: Tentu saja. GroupDocs.Annotation dapat merender pratinjau untuk lebih dari 30 format berbeda, termasuk DOCX, XLSX, PPTX, dan banyak tipe gambar.

T: Bagaimana saya memastikan pratinjau tidak mengungkap metadata tersembunyi?
J: Gunakan opsi HideMetadata dalam PreviewOptions; API menghapus semua properti dokumen sebelum merender gambar.

T: Apakah aman mengekspos endpoint pratinjau secara publik?
J: Aliran pratinjau dihasilkan di sisi server dan dapat disampaikan melalui HTTPS. Kombinasikan dengan otentikasi berbasis token untuk membatasi akses hanya kepada pengguna yang berwenang.

T: Apa kebijakan kedaluwarsa cache yang direkomendasikan?
J: Cache pratinjau selama masa versi dokumen sumber. Ketika cap waktu terakhir diubah, invalidasi gambar yang di‑cache dan buat ulang.

Sumber daya tambahan

Terakhir Diperbarui: 2026-08-09
Diuji Dengan: GroupDocs.Annotation 23.10 untuk .NET
Penulis: GroupDocs

Tutorial Terkait