Visualizzatore DOCX in ASP.NET Core: Anteprima dei file Word

Per visualizzare un documento Word all'interno di un'applicazione ASP.NET Core, utilizza un SDK visualizzatore DOCX che rende il file sul server e ne mostra le pagine nel browser. Doconut fornisce questo flusso di lavoro senza richiedere Microsoft Word sul server. I tuoi utenti possono leggere un contratto, una proposta o un report all'interno dell'applicazione invece di aprire un programma desktop separato.

La domanda utile è cosa succede quando sostituisci il file demo con i tuoi documenti. Un contratto può contenere caratteri personalizzati, intestazioni ripetute, tabelle larghe e pagine di firma. Questa guida mostra il passaggio di apertura del documento per un'applicazione .NET 8 e i controlli che ti aiutano a valutare il risultato.

Apri un file DOCX da C#

Inizia con la Guida rapida Doconut .NET 8 per configurare i servizi, la sessione ASP.NET, il middleware dei documenti, le risorse del visualizzatore e il widget del browser. Il seguente endpoint estende quell'applicazione configurata; non è un'applicazione completa autonoma.

Posiziona un documento di test non sensibile in App_Data/Sample.docx sotto la radice dei contenuti dell'applicazione. Aggiungi questo endpoint prima di 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 });
});

Mantieni la direttiva using con le altre importazioni in cima a Program.cs. Il percorso fisso rende l'esempio facile da riprodurre ed evita di accettare un percorso arbitrario dal browser.

Il Riferimento API Viewer documenta il sovraccarico del percorso file di OpenDocumentAsync. Apre il file e restituisce un token di sessione del documento. Nella pagina in cui la guida rapida ha già inizializzato objViewer, apri l'anteprima con:

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);
}

Chiama questa funzione dall'azione di anteprima della tua pagina e visualizza eventuali errori tramite l'interfaccia di errore esistente dell'applicazione. Mantieni la richiesta sulla stessa origine dell'applicazione del visualizzatore in questo esempio.

Mantieni l'accesso ai documenti sotto controllo dell'applicazione

In un portale clienti, sostituisci il campione fisso con un record documento selezionato dalla tua applicazione. Verifica che l'utente corrente possa visualizzare quel record prima di risolverne la posizione di archiviazione e aprirlo. Un nome file ricevuto dal browser non è una decisione di autorizzazione.

Conserva gli originali protetti al di fuori della radice web pubblica. La cartella App_Data dell'esempio è una convenzione di archiviazione, non una funzionalità di controllo accessi: non esporla tramite una mappatura di file statici. Mantieni l'autenticazione e i permessi dei documenti nell'applicazione host.

Il browser riceve un token di visualizzazione per la sessione del documento. Tratta quel token come una credenziale piuttosto che come un URL permanente del documento. La guida rapida copre anche la chiusura di un documento quando il lettore esce o apre un altro file.

Testa il layout Word con file rappresentativi

Un DOCX vuoto dimostra poco sui documenti che i tuoi clienti usano. Crea un piccolo set di valutazione dai modelli reali che la tua applicazione deve visualizzare, rimuovendo le informazioni sensibili.

Documento di test	Cosa controllare nell'anteprima
Contratto con intestazioni e piè di pagina	Contenuto ripetuto, numeri di pagina e posizionamento della pagina di firma
Proposta con un carattere aziendale	Sostituzione del carattere, a capo delle righe e larghezze delle intestazioni
Report con tabelle larghe o nidificate	Larghezze delle colonne, divisione delle righe e testo tagliato ai bordi della pagina
Documento con sezioni in verticale e orizzontale	Dimensioni della pagina e transizione tra le sezioni
Manuale ricco di immagini	Posizionamento delle immagini, didascalie e leggibilità con lo zoom

Confronta il risultato renderizzato con il documento sorgente approvato. Decidi quali differenze sono rilevanti per il tuo flusso di lavoro prima di procedere con l'integrazione.

Doconut espone impostazioni di rendering specifiche per Word tramite WordConfig. Il riferimento configurazione formato include FontFolders per directory di caratteri aggiuntive, impostazioni di formato carta e AutoFitAllTables per l'adattamento delle tabelle. Modifica queste impostazioni consapevolmente: far adattare una tabella alla larghezza disponibile può anche modificare il layout che stai cercando di preservare.

Ripeti i controlli sull'host di distribuzione. Un'anteprima che utilizza un carattere installato sulla macchina di sviluppo può apparire diversa quando quel carattere è assente dal server. Usa caratteri che la tua organizzazione è autorizzata a distribuire.

Scegli separatamente visualizzazione, modifica e conversione

Un'anteprima DOCX risolve il passo di lettura. Non trasforma la tua applicazione in un ambiente di authoring Word.

• Lettura: usa il visualizzatore quando qualcuno deve ispezionare un documento esistente all'interno di un caso, ordine o record cliente.
• Modifica: se gli utenti devono riscrivere paragrafi e salvare un DOCX aggiornato, valuta separatamente un flusso di lavoro di editing. L'anteprima di un file non è prova di supporto alla modifica Word.
• Conversione: se il requisito è un file scaricabile in un altro formato, valuta separatamente quel flusso di esportazione rispetto alla visualizzazione delle pagine.

La panoramica del visualizzatore Word per .NET descrive il percorso di visualizzazione della famiglia Word di Doconut. Usala per verificare l'adeguatezza del prodotto, poi utilizza i tuoi file per valutare il comportamento di rendering che conta per la tua applicazione.

Valuta il visualizzatore con il documento più complesso per primo

Inizia con un documento che già genera richieste di supporto: un contratto lungo, un report ricco di tabelle o un modello con caratteri insoliti. Controlla l'anteprima, naviga tra diverse pagine, riaprila in una nuova sessione e verifica che l'applicazione circostante applichi i permessi corretti sul documento.

Scarica Doconut ed esegui il campione .NET 8 con quel file. Una valutazione riuscita dovrebbe dimostrare che gli utenti possono leggere i documenti che effettivamente ricevono, con un layout revisionato dal tuo team e un'integrazione che la tua applicazione può mantenere.