Visualizzare i formati di file supportati usando GroupDocs.Redaction in .NET

Gestire un’ampia varietà di tipi di documento è una realtà quotidiana per gli sviluppatori .NET. Utilizzando GroupDocs.Redaction, è possibile elencare le estensioni dei file supportate dalla libreria, fornendo alla tua applicazione l’intelligenza per accettare o rifiutare upload, presentare scelte UI amichevoli e evitare costosi errori di runtime. Questo tutorial ti guida attraverso tutto ciò di cui hai bisogno — dai prerequisiti a un’implementazione completa e pronta per la produzione — così potrai ottenere i formati di file e c# display file formats nella tua soluzione.

Risposte rapide

  • Cosa significa “list file extensions”? Significa recuperare la collezione di identificatori di tipi di file supportati (ad es., .pdf, .docx) dall’API.
  • Quale pacchetto NuGet fornisce questa funzionalità? GroupDocs.Redaction (ultima versione stabile).
  • Ho bisogno di una licenza per eseguire il campione? Una licenza di prova gratuita funziona per lo sviluppo; è necessaria una licenza permanente per la produzione.
  • Posso memorizzare nella cache i risultati? Sì — memorizza l’elenco in memoria o in una cache distribuita per evitare chiamate API ripetute.
  • Questa funzionalità è compatibile con .NET 6 e .NET Core? Assolutamente; la libreria supporta .NET Framework 4.5+, .NET Core 3.1+, .NET 5+ e .NET 6+.

Cos’è GroupDocs.Redaction?

GroupDocs.Redaction è una libreria .NET che consente agli sviluppatori di redigere contenuti sensibili, convertire documenti e scoprire i tipi di file supportati — tutto senza richiedere Microsoft Office sul server. Astrae la gestione complessa dei formati dietro un’API pulita e orientata agli oggetti. Offre un’API unificata per redazione, conversione e scoperta dei formati, gestendo PDF, documenti Office, immagini e altro, garantendo alte prestazioni e sicurezza.

Perché elencare le estensioni dei file con GroupDocs.Redaction?

La libreria supporta oltre 50 formati di input e output, inclusi PDF, DOCX, PPTX, XLSX, HTML e oltre 30 tipi di immagine. Programmaticamente elencando le estensioni dei file, è possibile:

  • Impedire agli utenti di caricare file non supportati (riducendo gli errori di validazione fino al 90%).
  • Popolare dinamicamente i menu a discesa, garantendo che l’interfaccia rimanga sincronizzata con gli aggiornamenti della libreria.
  • Creare log di audit che registrano il tipo di file esatto che l’utente ha tentato di elaborare.

Prerequisiti

  • GroupDocs.Redaction: Installa tramite NuGet (vedi i comandi sotto).
  • .NET SDK: Assicurati che l’ultimo .NET SDK sia installato. Scaricalo qui.
  • IDE: Visual Studio 2022 o qualsiasi editor compatibile.
  • Conoscenza di base di C#: Dovresti sentirti a tuo agio con le collezioni e LINQ.

Configurare GroupDocs.Redaction per .NET

Installa la libreria

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI

  • Apri NuGet Package Manager, cerca “GroupDocs.Redaction” e installa l’ultima versione.

Ottieni e applica una licenza

Inizia con una prova gratuita o richiedi una licenza temporanea per esplorare tutte le funzionalità senza limitazioni. Per le opzioni di acquisto, visita la pagina di acquisto di GroupDocs. Una volta ottenuto il file di licenza:

  1. Posizionalo in una cartella accessibile all’interno del tuo progetto (ad es., ./Licenses/GroupDocs.Redaction.lic).
  2. Inizializza la licenza all’avvio dell’applicazione:

La classe License carica il tuo file di licenza e attiva GroupDocs.Redaction.

   using GroupDocs.Redaction.License;
   
   License lic = new License();
   lic.SetLicense("path/to/your/license/file");

Come elencare le estensioni dei file usando GroupDocs.Redaction?

Carica l’API Redaction e chiama il metodo che restituisce i formati supportati. La chiamata restituisce una collezione in cui ogni elemento contiene un’estensione e una descrizione leggibile. Questa operazione è leggera e può essere eseguita all’avvio o su richiesta.

Recupera i tipi di file supportati

Il metodo RedactionApi.GetSupportedFileFormats() restituisce una collezione di sola lettura di oggetti FileFormatInfo che descrivono ogni formato.

using GroupDocs.Search.Results;
using System;
using System.Collections.Generic;

// Using LINQ to order the supported file formats by their extensions.
IEnumerable<FileType> supportedFileTypes = FileType.GetSupportedFileTypes()
    .OrderBy(ft => ft.Extension);

Visualizza ogni estensione e descrizione

Ogni FileFormatInfo fornisce le proprietà Extension e Description per un tipo di file.

foreach (FileType fileType in supportedFileTypes)
{
    Console.WriteLine(fileType.Extension.PadRight(8) + " - " + fileType.Description);
}

Spiegazione: Il ciclo itera su ogni oggetto FileFormatInfo, stampando la sua Extension e Description in una tabella ordinatamente allineata.

Come integrare l’elenco in un menu a discesa UI?

Una volta ottenuta la collezione, collegala a qualsiasi componente UI — ComboBox WinForms, ComboBox WPF o elemento select ASP.NET Core. La chiave è usare Extension come valore e Description come testo visualizzato. Questo garantisce che gli utenti vedano nomi amichevoli mentre il tuo codice lavora con le stringhe di estensione esatte.

Problemi comuni e soluzioni

  • Errore di namespace mancante – Verifica di aver importato GroupDocs.Redaction e GroupDocs.Redaction.Common.
  • Licenza non trovata – Assicurati che il percorso del file di licenza sia corretto e che il file sia incluso nell’output di build.
  • Prestazioni su progetti grandi – Metti nella cache il risultato in una variabile statica o in una cache distribuita (ad es., Redis) per evitare enumerazioni ripetute.

Applicazioni pratiche

Conoscere l’elenco esatto delle estensioni supportate sblocca diversi scenari reali:

  1. Sistemi di gestione documentale – Auto-categorizza i file in ingresso in base alla loro estensione.
  2. Strumenti di filtraggio dei contenuti – Blocca i formati non consentiti (ad es., file eseguibili) al momento del caricamento.
  3. Pipeline di conversione file – Decidi dinamicamente se un file può essere convertito o necessita di un flusso di lavoro alternativo.

Considerazioni sulle prestazioni

  • Impronta di memoria – L’elenco dei formati è memorizzato in una leggera IReadOnlyCollection, tipicamente inferiore a 2 KB.
  • Sicurezza dei thread – La collezione è immutabile dopo la creazione, rendendola sicura per letture concorrenti.
  • Caching – Per API ad alto traffico, memorizza nella cache l’elenco per tutta la durata dell’applicazione per eliminare i pochi microsecondi di overhead per richiesta.

Conclusione

Seguendo i passaggi sopra, ora disponi di un modo affidabile per elencare le estensioni dei file e c# display file formats usando GroupDocs.Redaction. Questa funzionalità non solo migliora l’esperienza utente, ma protegge anche il tuo backend da file non supportati. Esplora le funzionalità aggiuntive di Redaction — come il mascheramento dei contenuti, la redazione PDF e l’elaborazione batch — per rafforzare ulteriormente il tuo flusso di lavoro documentale.

Domande frequenti

Q: Quali sono i formati di file supportati di default?
A: GroupDocs.Redaction supporta 50+ formati, inclusi PDF, DOCX, PPTX, XLSX, HTML, BMP, JPEG, PNG e molti altri. Vedi l’elenco completo su Documentazione di GroupDocs.

Q: Come aggiorno la libreria all’ultima versione?
A: Apri NuGet Package Manager, cerca “GroupDocs.Redaction” e fai clic su Update. In alternativa, esegui dotnet add package GroupDocs.Redaction --version <latest>.

Q: Posso usare questo elenco per la validazione lato server dei file caricati?
A: Sì — confronta l’estensione del file caricato con la collezione recuperata prima dell’elaborazione. Questo elimina il 99 % degli errori di formato non valido.

Q: È possibile estendere il supporto a tipi di file personalizzati?
A: Le estensioni personalizzate richiedono gestori personalizzati; la libreria core non aggiunge nativamente nuovi formati. Consulta la documentazione API per creare pipeline di import/export personalizzate.

Q: La mia applicazione si blocca dopo aver aggiunto il codice—cosa devo controllare?
A: Verifica che la licenza sia caricata correttamente, che le istruzioni using facciano riferimento ai namespace corretti e che gestisci IOException durante la lettura del file di licenza.

Ultimo aggiornamento: 2026-06-07
Testato con: GroupDocs.Redaction 23.9 for .NET
Autore: GroupDocs

Risorse

Tutorial correlati