Penampil DOCX di ASP.NET Core: Pratinjau File Word

Untuk menampilkan pratinjau dokumen Word di dalam aplikasi ASP.NET Core, gunakan SDK penampil DOCX yang merender file di server dan menampilkan halamannya di browser. Doconut menyediakan alur kerja ini tanpa memerlukan Microsoft Word di server. Pengguna Anda dapat membaca kontrak, proposal, atau laporan di dalam aplikasi Anda alih-alih membuka program desktop terpisah.

Laporan berwarna gading dengan tabel dan diagram yang keluar dari folder biru tua ke dalam bingkai tampilan kaca transparan

Pertanyaan yang berguna adalah apa yang terjadi ketika Anda mengganti file demo dengan dokumen Anda sendiri. Sebuah kontrak dapat berisi font khusus, header berulang, tabel lebar, dan halaman tanda tangan. Panduan ini menunjukkan langkah pembukaan dokumen untuk aplikasi .NET 8 dan pemeriksaan yang membantu Anda mengevaluasi hasilnya.

Membuka file DOCX dari C#

Mulailah dengan Doconut .NET 8 panduan cepat untuk mengonfigurasi layanan, sesi ASP.NET, middleware dokumen, sumber daya penampil, dan widget browser. Endpoint berikut memperluas aplikasi yang telah dikonfigurasi; ini bukan aplikasi mandiri lengkap.

Tempatkan dokumen uji yang tidak sensitif di App_Data/Sample.docx di bawah root konten aplikasi. Tambahkan endpoint ini sebelum app.Run():

using Doconut;

app.MapPost("/api/preview-word", async (
    Viewer viewer,
    IWebHostEnvironment environment) =>
{
    var filePath = Path.Combine(
        environment.ContentRootPath, "App_Data", "Sample.docx");

    if (!File.Exists(filePath))
        return Results.NotFound();

    var token = await viewer.OpenDocumentAsync(filePath);
    return Results.Ok(new { token });
});

Pertahankan direktif using bersama impor lainnya di bagian atas Program.cs. Jalur tetap membuat contoh mudah direproduksi dan menghindari menerima jalur server sewenang-wenang dari browser.

Referensi API Penampil mendokumentasikan overload jalur‑berkas dari OpenDocumentAsync. Itu membuka file dan mengembalikan token sesi dokumen. Pada halaman di mana panduan cepat telah menginisialisasi objViewer, buka pratinjau dengan:

async function previewWordDocument() {
    const response = await fetch('/api/preview-word', {
        method: 'POST'
    });

    if (!response.ok) {
        throw new Error('The Word preview could not be opened.');
    }

    const { token } = await response.json();
    objViewer.View(token);
}

Panggil fungsi ini dari aksi pratinjau halaman Anda dan tampilkan setiap kesalahan melalui UI error yang sudah ada di aplikasi. Pertahankan permintaan pada asal aplikasi yang sama dengan penampil dalam contoh ini.

Jaga akses dokumen di bawah kontrol aplikasi

Di portal pelanggan, ganti contoh tetap dengan rekaman dokumen yang dipilih oleh aplikasi Anda. Periksa bahwa pengguna saat ini dapat melihat rekaman tersebut sebelum menentukan lokasi penyimpanannya dan membukanya. Nama file yang diterima dari browser bukan keputusan otorisasi.

Simpan asli yang dilindungi di luar root web publik. Folder App_Data pada contoh adalah konvensi penyimpanan, bukan fitur kontrol akses: jangan mengeksposnya melalui pemetaan file statis. Pertahankan otentikasi dan izin dokumen di aplikasi host.

Browser menerima token tampilan untuk sesi dokumen. Perlakukan token tersebut sebagai kredensial, bukan URL dokumen permanen. Panduan cepat juga mencakup penutupan dokumen ketika pembaca meninggalkan atau membuka file lain.

Uji tata letak Word dengan file representatif

DOCX kosong memberikan sedikit informasi tentang dokumen yang digunakan pelanggan Anda. Bangun satu set evaluasi kecil dari templat aktual yang perlu ditampilkan aplikasi Anda, dengan informasi sensitif dihapus.

Dokumen uji	Apa yang harus diperiksa dalam pratinjau
Kontrak dengan header dan footer	Konten berulang, nomor halaman, dan penempatan halaman tanda tangan
Proposal menggunakan font perusahaan	Penggantian font, pembungkus baris, dan lebar heading
Laporan dengan tabel lebar atau bersarang	Lebar kolom, pemisahan baris, dan teks terpotong pada batas halaman
Dokumen yang mencampur bagian potret dan lanskap	Dimensi halaman dan transisi antar bagian
Manual dengan banyak gambar	Penempatan gambar, keterangan, dan keterbacaan saat diperbesar

Bandingkan hasil render dengan dokumen sumber yang disetujui. Tentukan perbedaan mana yang penting bagi alur kerja Anda sebelum berkomitmen pada integrasi.

Doconut mengekspos pengaturan rendering khusus Word melalui WordConfig. Referensi konfigurasi format mencakup FontFolders untuk direktori font tambahan, pengaturan ukuran kertas, dan AutoFitAllTables untuk penyesuaian tabel. Ubah ini secara sengaja: membuat tabel menyesuaikan lebar yang tersedia juga dapat mengubah tata letak yang ingin Anda pertahankan. Lihat referensi konfigurasi format untuk detail lebih lanjut.

Ulangi pemeriksaan pada host penyebaran. Pratinjau yang menggunakan font yang terpasang di mesin pengembang dapat terlihat berbeda ketika font tersebut tidak ada di server. Gunakan font yang diizinkan organisasi Anda untuk menyebarkan.

Pilih penampilan, penyuntingan, dan konversi secara terpisah

Pratinjau DOCX menyelesaikan langkah membaca. Itu tidak mengubah aplikasi Anda menjadi lingkungan penulisan Word.

Membaca: gunakan penampil ketika seseorang perlu memeriksa dokumen yang ada di dalam kasus, pesanan, atau rekaman pelanggan.
Penyuntingan: jika pengguna harus menulis ulang paragraf dan menyimpan DOCX yang diperbarui, evaluasi alur kerja penyuntingan secara terpisah. Pratinjau file bukan bukti dukungan penyuntingan Word.
Konversi: jika kebutuhan adalah file yang dapat diunduh dalam format lain, nilai alur kerja ekspor tersebut secara terpisah dari penampilan halaman.

Gambaran penampil Word untuk .NET menjelaskan jalur penampilan keluarga Word Doconut. Gunakan itu untuk memeriksa kecocokan produk, lalu gunakan file Anda sendiri untuk menilai perilaku rendering yang penting bagi aplikasi Anda.

Evaluasi penampil dengan dokumen tersulit Anda terlebih dahulu

Mulailah dengan dokumen yang sudah menyebabkan permintaan dukungan: kontrak panjang, laporan dengan banyak tabel, atau templat dengan font yang tidak biasa. Periksa pratinjau, jelajahi beberapa halaman, buka kembali dalam sesi baru, dan verifikasi bahwa aplikasi sekitarnya menegakkan izin dokumen yang tepat.

Unduh Doconut dan jalankan contoh .NET 8 dengan file tersebut. Evaluasi yang berhasil harus menunjukkan bahwa pengguna dapat membaca dokumen yang mereka terima, dengan tata letak yang telah ditinjau tim Anda dan integrasi yang dapat dipertahankan oleh aplikasi Anda.