Recupera e aggiorna le informazioni della presentazione in .NET

Di cosa tratta questa pagina

Esplora diapositive, struttura e metadati nelle presentazioni PowerPoint e OpenDocument usando .NET per ottenere rapidamente informazioni e audit di contenuto più intelligenti.

Panoramica

Aspose.Slides può identificare il formato di una presentazione e leggere i metadati del documento senza creare un modello completo dell’oggetto presentazione. Questo è utile quando è necessario classificare i file, creare un inventario o ispezionare le proprietà prima di decidere se caricare ed elaborare il contenuto della presentazione.

Questo articolo dimostra l’ispezione leggera tramite PresentationFactory e IPresentationInfo, nonché gli aggiornamenti mirati tramite IDocumentProperties.

Verifica il formato di una presentazione

Se hai già una presentazione caricata, consulta Determine the Original Presentation Format per la rilevazione dopo il caricamento e le limitazioni dei flussi legacy PPT, PPS e POT.

Utilizza PresentationFactory.GetPresentationInfo per ispezionare un file senza creare un’istanza di Presentation. La proprietà IPresentationInfo.LoadFormat restituisce il formato rilevato, ad esempio PPTX, PPT o ODP.

using System;
using Aspose.Slides;

var fileNames = new[] { "pres.pptx", "pres.ppt", "pres.odp" };

foreach (var fileName in fileNames)
{
    var presentationInfo = PresentationFactory.Instance.GetPresentationInfo(fileName);
    Console.WriteLine($"{fileName}: {presentationInfo.LoadFormat}");
}

Crea un inventario di presentazioni leggero

Quando elabori molti file di presentazione, potresti aver bisogno di un inventario compatto per convalida, indicizzazione o un sistema di gestione documentale. In questo scenario, utilizza PresentationFactory.GetPresentationInfo per ottenere un oggetto IPresentationInfo e quindi chiama IPresentationInfo.ReadDocumentProperties per leggere i metadati del documento. Questo approccio non crea un’istanza di Presentation né richiede di attraversare l’intero modello dell’oggetto presentazione.

Le proprietà estese esposte da IDocumentProperties forniscono i seguenti valori di inventario:

Proprietà	Valore dell’inventario
Slides	Numero totale di diapositive.
HiddenSlides	Numero di diapositive nascoste.
Notes	Numero di diapositive che contengono note.
Paragraphs	Numero totale di paragrafi, se disponibili.
Words	Numero totale di parole.
MultimediaClips	Numero totale di clip audio e video.

L’esempio seguente legge questi valori senza creare un oggetto Presentation e stampa un inventario compatto. Combina inoltre HeadingPairs con TitlesOfParts per visualizzare gruppi di contenuti come caratteri, temi e titoli delle diapositive.

using System;
using System.IO;
using Aspose.Slides;

var filePath = "sample.pptx";
var presentationInfo = PresentationFactory.Instance.GetPresentationInfo(filePath);
var documentProperties = presentationInfo.ReadDocumentProperties();

Console.WriteLine($"File: {Path.GetFileName(filePath)}");
Console.WriteLine($"Format: {presentationInfo.LoadFormat}");
Console.WriteLine($"Title: {documentProperties.Title}");
Console.WriteLine($"Author: {documentProperties.Author}");
Console.WriteLine("Statistics:");
Console.WriteLine($"  Slides: {documentProperties.Slides}");
Console.WriteLine($"  Hidden slides: {documentProperties.HiddenSlides}");
Console.WriteLine($"  Slides with notes: {documentProperties.Notes}");
Console.WriteLine($"  Paragraphs: {documentProperties.Paragraphs}");
Console.WriteLine($"  Words: {documentProperties.Words}");
Console.WriteLine($"  Multimedia clips: {documentProperties.MultimediaClips}");

var headingPairs = documentProperties.HeadingPairs ?? Array.Empty<IHeadingPair>();
var titlesOfParts = documentProperties.TitlesOfParts ?? Array.Empty<string>();
var partIndex = 0;

if (headingPairs.Length == 0 || titlesOfParts.Length == 0)
{
    Console.WriteLine("Content groups: not available");
}
else
{
    Console.WriteLine("Content groups:");

    foreach (var headingPair in headingPairs)
    {
        Console.WriteLine($"  {headingPair.Name} ({headingPair.Count})");

        for (var partOffset = 0; partOffset < headingPair.Count && partIndex < titlesOfParts.Length; partOffset++)
        {
            Console.WriteLine($"    - {titlesOfParts[partIndex]}");
            partIndex++;
        }
    }

    if (partIndex < titlesOfParts.Length)
    {
        Console.WriteLine("  Other parts:");

        while (partIndex < titlesOfParts.Length)
        {
            Console.WriteLine($"    - {titlesOfParts[partIndex]}");
            partIndex++;
        }
    }
}

Ogni IHeadingPair fornisce un nome di gruppo e il numero di elementi in quel gruppo. IDocumentProperties.TitlesOfParts è un array piatto e ordinato, quindi consuma il numero di titoli consecutivi specificati da ciascuna coppia di intestazione.

Metadati archiviati e limitazioni del formato

Le proprietà dell’inventario restituite da IPresentationInfo.ReadDocumentProperties riflettono i metadati disponibili nel documento sorgente. Aspose.Slides non carica e attraversa il modello dell’oggetto presentazione per ricalcolare questi valori per questa chiamata. Le proprietà mancanti sono rappresentate da valori predefiniti e i valori archiviati possono essere obsoleti se l’applicazione che ha salvato per ultima il file non ha aggiornato le sue proprietà documento.

• PPTX: il formato fornisce proprietà documento estese per conteggi di diapositive, note, diapositive nascoste, paragrafi, parole e multimedia, nonché coppie di intestazione e titoli di parti. La disponibilità dipende dalle proprietà scritte dal produttore del documento.
• PPT: il formato binario può memorizzare le corrispondenti proprietà di riepilogo documento. Se una proprietà è assente o non è stata aggiornata dal produttore del documento, Aspose.Slides restituisce il valore archiviato o predefinito anziché calcolarlo dalle diapositive.
• ODP: i metadati OpenDocument forniscono statistiche generali del documento, come conteggi di pagine, paragrafi e parole, ma questi valori non corrispondono a tutte le proprietà estese specifiche di PowerPoint. I metadati relativi a diapositive nascoste, note, multimedia, coppie di intestazione e titoli di parti potrebbero non essere disponibili e le proprietà dell’inventario potrebbero restituire valori predefiniti. Non considerare un valore zero o un array vuoto come prova autorevole dell’assenza del contenuto corrispondente.

Utilizza l’approccio di metadati leggeri per inventari e controlli preliminari. Carica la presentazione e ispeziona il suo modello di oggetto live quando il risultato deve riflettere modifiche in memoria o quando è necessario verificare il contenuto effettivo della presentazione.

Aggiorna le proprietà della presentazione

Le proprietà restituite da IPresentationInfo.ReadDocumentProperties possono essere modificate anche senza creare un’istanza di Presentation. Applica le modifiche con IPresentationInfo.UpdateDocumentProperties e poi scrivi la presentazione legata con IPresentationInfo.WriteBindedPresentation.

L’immagine seguente mostra le proprietà originali del documento.

L’esempio seguente modifica il titolo e l’ora dell’ultimo salvataggio e scrive il risultato in un nuovo file:

using System;
using System.IO;
using Aspose.Slides;

var sourceFile = "sample.pptx";
var outputFile = "sample_with_updated_properties.pptx";
var presentationInfo = PresentationFactory.Instance.GetPresentationInfo(sourceFile);
var documentProperties = presentationInfo.ReadDocumentProperties();

documentProperties.Title = "Quarterly sales report";
documentProperties.LastSavedTime = DateTime.UtcNow;

presentationInfo.UpdateDocumentProperties(documentProperties);
using var outputStream = File.Create(outputFile);
presentationInfo.WriteBindedPresentation(outputStream);

L’immagine seguente mostra le proprietà del documento modificate.

Link utili

Per controlli di sicurezza correlati e impostazioni di protezione, consulta i seguenti articoli:

• Presentazioni protette da password
• Presentazioni protette da scrittura

FAQ

Come posso verificare se i caratteri sono incorporati e quali sono?

Carica la presentazione e utilizza Presentation.FontsManager. Chiama FontsManager.GetEmbeddedFonts per ottenere i caratteri incorporati e FontsManager.GetFonts per ottenere i caratteri usati dalla presentazione. Confronta i due risultati per individuare i caratteri richiesti per il rendering ma non incorporati.

Come posso rapidamente capire se il file ha diapositive nascoste e quante?

Quando i metadati del documento archiviati sono sufficienti, leggi IDocumentProperties.HiddenSlides tramite PresentationFactory.GetPresentationInfo e IPresentationInfo.ReadDocumentProperties. Questo è adatto per un inventario leggero. Se la presentazione è stata modificata in memoria, i metadati archiviati potrebbero mancare o essere obsoleti, oppure è necessario verificare i valori live, iterando su Presentation.Slides e ispezionando la proprietà Slide.Hidden di ciascuna diapositiva.

Posso rilevare se è usata una dimensione e un’orientazione della diapositiva personalizzate e se differiscono dai valori predefiniti?

Sì. Carica la presentazione e leggi Presentation.SlideSize. Ispeziona ISlideSize.Type, ISlideSize.Size e ISlideSize.Orientation per confrontare le impostazioni correnti con il preset e le dimensioni attese.

Esiste un modo rapido per vedere se i grafici fanno riferimento a fonti dati esterne?

Sì. Individua ogni Chart e ispeziona ChartData.DataSourceType. Per una cartella di lavoro esterna, leggi ChartData.ExternalWorkbookPath. Il tipo di origine dati e il percorso identificano un riferimento esterno, ma verificare la disponibilità della destinazione richiede un controllo delle risorse separato.

Come posso valutare le diapositive ‘pesanti’ che potrebbero rallentare il rendering o l’esportazione PDF?

Non esiste una singola proprietà di complessità. Attraversa Presentation.Slides e la collezione IBaseSlide.Shapes di ciascuna diapositiva. Usa il conteggio delle forme e la presenza di immagini grandi, effetti, animazioni o multimedia come segnali di screening, e misura un rendering o un’esportazione rappresentativa prima di considerare una diapositiva come colpo di bottiglia confermato delle prestazioni.