ExportDocumentStructure

PdfSaveOptions.ExportDocumentStructure property

Ottiene o imposta un valore che determina se esportare o meno la struttura del documento.

public bool ExportDocumentStructure { get; set; }

Osservazioni

Questo valore viene ignorato durante il salvataggio in formato PDF/A-1a, PDF/A-2a e PDF/UA-1 perché per questa conformità è richiesta la struttura del documento.

Si noti che l’esportazione della struttura del documento aumenta significativamente il consumo di memoria, soprattutto per i documenti di grandi dimensioni.

Esempi

Mostra come preservare gli elementi della struttura del documento, il che può facilitare l’interpretazione programmatica del nostro documento.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.ParagraphFormat.Style = doc.Styles["Heading 1"];
builder.Writeln("Hello world!");
builder.ParagraphFormat.Style = doc.Styles["Normal"];
builder.Write(
    "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");

// Creiamo un oggetto "PdfSaveOptions" che possiamo passare al metodo "Save" del documento
// per modificare il modo in cui quel metodo converte il documento in .PDF.
PdfSaveOptions options = new PdfSaveOptions();
// Imposta la proprietà "ExportDocumentStructure" su "true" per rendere la struttura del documento, come i tag, disponibile tramite
// Riquadro di navigazione "Contenuto" di Adobe Acrobat a scapito dell'aumento delle dimensioni del file.
// Impostare la proprietà "ExportDocumentStructure" su "false" per non esportare la struttura del documento.
options.ExportDocumentStructure = exportDocumentStructure;

// Supponiamo di esportare la struttura del documento durante il salvataggio di questo documento. In tal caso,
// possiamo aprirlo utilizzando Adobe Acrobat e trovare i tag per elementi come l'intestazione
// e il paragrafo successivo tramite "Visualizza" -> "Mostra/Nascondi" -> "Riquadri di navigazione" -> "Tag".
doc.Save(ArtifactsDir + "PdfSaveOptions.ExportDocumentStructure.pdf", options);

Guarda anche

PdfSaveOptions.EncryptionDetails PdfSaveOptions.ExportLanguageToSpanTag