Come esportare documenti redatti con GroupDocs.Redaction .NET

In questa guida completa scoprirai come esportare contenuti redatti in modo sicuro ed efficiente usando GroupDocs.Redaction per .NET. Che tu debba mantenere il tipo di file originale, bloccare il documento come PDF rasterizzato o trasmettere il risultato direttamente in memoria, ti guideremo attraverso ogni opzione con spiegazioni chiare, conversazionali e consigli pratici. Alla fine di questo tutorial sarai in grado di scegliere la strategia di esportazione giusta per qualsiasi scenario guidato dalla conformità.

Risposte rapide

  • Quali formati posso esportare? Qualsiasi dei più di 30 formati nativi supportati da GroupDocs.Redaction, più PDF rasterizzato per la massima sicurezza.
  • Ho bisogno di una licenza per lo streaming? Sì, è necessaria una licenza valida di GroupDocs.Redaction per lo streaming in produzione.
  • Posso impostare una cartella di output personalizzata? Assolutamente – usa la proprietà OutputPath o SaveOptions per configurarla.
  • La rasterizzazione è sicura per file di grandi dimensioni? Gestisce documenti fino a 500 pagine senza caricare l’intero file in memoria.
  • Quali versioni di .NET sono supportate? .NET Framework 4.6+, .NET Core 3.1+, .NET 5/6/7.

Cos’è GroupDocs.Redaction?

GroupDocs.Redaction è una libreria .NET che rimuove o maschera programmaticamente le informazioni sensibili da PDF, Word, Excel, PowerPoint, immagini e molti altri formati. Offre un’API di alto livello per definire le regioni di redazione, applicare le politiche e infine esportare il documento pulito. Questo rende semplice integrare le funzionalità di redazione in qualsiasi applicazione .NET.

Perché esportare documenti redatti come PDF rasterizzati?

I PDF rasterizzati convertono ogni pagina in un’immagine piatta, eliminando i livelli di testo nascosti che potrebbero essere estratti in seguito. Questo formato garantisce che i contenuti redatti non possano essere recuperati, soddisfacendo rigorosi standard normativi come GDPR e HIPAA. GroupDocs.Redaction può generare PDF rasterizzati fino a 300 dpi, preservando la fedeltà visiva garantendo al contempo la sicurezza.

Come esportare documenti redatti?

Carica il file sorgente, applica le regole di redazione, quindi chiama il metodo di salvataggio appropriato—Save per il formato originale, SaveAsRasterizedPdf per PDF solo immagine, o SaveToStream per la gestione in memoria. Di seguito il flusso di lavoro passo‑passo. Ogni metodo garantisce che il contenuto redatto sia rimosso in modo permanente mantenendo il formato di output desiderato.

Passo 1: Installa il pacchetto NuGet

Aggiungi il pacchetto più recente di GroupDocs.Redaction al tuo progetto:

dotnet add package GroupDocs.Redaction

Passo 2: Carica il documento e definisci le redazioni

Crea un’istanza di Redactor, carica il file e specifica le regioni che desideri nascondere. La classe Redactor fornisce la funzionalità principale per caricare i documenti e applicare le regole di redazione.

using GroupDocs.Redaction;
using GroupDocs.Redaction.Options;

// Load the document
var redactor = Redactor.Create("SensitiveReport.docx");

// Define a redaction for a specific text pattern
redactor.Apply(new RedactionOptions
{
    SearchPattern = "SSN: \\d{3}-\\d{2}-\\d{4}",
    RedactionColor = System.Drawing.Color.Black,
    RedactionType = RedactionType.Image
});

Passo 3: Scegli il metodo di esportazione

Esporta nel formato originale

redactor.Save("RedactedReport.docx");

Esporta come PDF rasterizzato

var rasterOptions = new RasterizationOptions { Dpi = 300 };
redactor.SaveAsRasterizedPdf("RedactedReport.pdf", rasterOptions);

Esporta in uno stream di memoria (ideale per API web)

using var stream = new MemoryStream();
redactor.Save(stream, SaveOptions.CreatePdf());
stream.Position = 0; // Reset for reading

Il metodo Save scrive il documento redatto in un file nel suo formato originale. SaveAsRasterizedPdf crea un PDF in cui ogni pagina è resa come immagine, rimuovendo qualsiasi testo nascosto. SaveToStream restituisce il file redatto come stream di memoria, adatto per le risposte web.

Come configurare una cartella di output?

Imposta la proprietà OutputPath sul Redactor o passa un oggetto SaveOptions personalizzato che includa la directory desiderata. OutputPath è una proprietà del Redactor che specifica la cartella in cui vengono scritti i file di output. SaveOptions consente di personalizzare vari parametri di salvataggio, inclusa la cartella di output. Questo garantisce che tutti i file esportati vengano salvati in una posizione prevedibile, semplificando le pipeline di elaborazione batch. È inoltre possibile specificare sottocartelle per tipo di documento per mantenere organizzato lo spazio di lavoro.

var options = SaveOptions.CreatePdf();
options.OutputPath = @"C:\RedactedOutputs\";
redactor.Save(options);

Problemi comuni e soluzioni

  • Redazione non applicata: Verifica che il modello di ricerca corrisponda esattamente al testo del documento; usa RegexOptions.IgnoreCase se necessario. RegexOptions è un’enumerazione che controlla il comportamento del matching delle espressioni regolari, come la sensibilità al maiuscolo/minuscolo.
  • I file di grandi dimensioni causano pressione sulla memoria: Abilita la modalità streaming usando SaveToStream ed evita di chiamare Save sull’intero documento.
  • Il PDF rasterizzato appare sfocato: Aumenta i DPI in RasterizationOptions (ad es., 300–600) per migliorare la qualità dell’immagine. RasterizationOptions consente di impostare parametri come DPI e formato immagine per l’output PDF rasterizzato.

Domande frequenti

Q: Posso esportare in un formato che non era originariamente supportato?
A: Sì, GroupDocs.Redaction può convertire la maggior parte dei tipi di input in PDF, DOCX, XLSX, PPTX o PDF rasterizzato, coprendo oltre 30 formati.

Q: Come la rasterizzazione protegge i dati redatti?
A: Renderizzando ogni pagina come immagine piatta, tutti i livelli di testo nascosti vengono rimossi, rendendo impossibile estrarre il contenuto originale.

Q: È possibile concatenare più regole di redazione?
A: Assolutamente – puoi chiamare Apply ripetutamente o passare una collezione di RedactionOptions per elaborare molti pattern in un unico passaggio. RedactionOptions definisce le impostazioni per una singola operazione di redazione, come la regione e il tipo di sostituzione.

Q: Devo chiudere l’oggetto Redactor?
A: Il Redactor implementa IDisposable; avvolgilo in un blocco using o chiama Dispose() per rilasciare rapidamente le handle dei file. IDisposable è un’interfaccia che fornisce un meccanismo per rilasciare risorse non gestite.

Q: Quali runtime .NET sono ufficialmente testati?
A: GroupDocs.Redaction è validato su .NET Framework 4.6+, .NET Core 3.1+, e .NET 5/6/7.

Risorse aggiuntive

Tutorial disponibili

Last Updated: 2026-06-11
Tested With: GroupDocs.Redaction 23.11 for .NET
Author: GroupDocs

Tutorial correlati