Gestire le proprietà della presentazione in .NET

Introduzione

Aspose.Slides for .NET supporta predefinite e personalizzate proprietà del documento. Utilizza queste proprietà per leggere e aggiornare i metadati della presentazione, come l’autore, il titolo e i valori definiti dall’utente.

Aspose.Slides consente di lavorare con le proprietà del documento della presentazione tramite l’interfaccia IDocumentProperties . Una istanza di questa interfaccia è restituita da IPresentation.DocumentProperties. I seguenti esempi mostrano come leggere, modificare e gestire queste proprietà.

Gestire le proprietà della presentazione

Le proprietà del documento memorizzano informazioni descrittive accanto al contenuto della presentazione. Si dividono in due categorie:

  • Proprietà predefinite contengono metadati standard, come il titolo, l’autore e le statistiche del documento.
  • Proprietà personalizzate memorizzano coppie nome/valore definite dall’utente.

Aspose.Slides per .NET fornisce l’accesso a entrambe le categorie. In PowerPoint, seleziona File → Info → Properties → Advanced Properties per esaminare i metadati del documento. La finestra di dialogo raggruppa le informazioni in schede come Summary, Statistics, Contents e Custom. Usa la scheda Custom per gestire le proprietà definite dall’utente.

Leggere le proprietà pubbliche da una presentazione crittografata

Una password di apertura protegge normalmente sia il contenuto della presentazione sia le proprietà del documento. Quando una presentazione è crittografata con IProtectionManager.EncryptDocumentProperties impostato su false, le sue proprietà del documento rimangono pubbliche. Un’applicazione può quindi impostare LoadOptions.OnlyLoadDocumentProperties su true e leggere i metadati pubblici senza fornire la password di apertura.

LoadOptions.OnlyLoadDocumentProperties controlla ciò che Aspose.Slides carica; non decrittografa nulla. Se le proprietà erano incluse nella crittografia, il loro caricamento senza la password fallisce. Se la presentazione non è crittografata, l’opzione viene ignorata e l’intera presentazione viene caricata.

L’esempio richiede una presentazione crittografata le cui proprietà del documento sono state lasciate pubbliche. Verifica la modalità di caricamento tramite IProtectionManager.IsOnlyDocumentPropertiesLoaded e quindi legge le proprietà predefinite tramite IPresentation.DocumentProperties :

using System;
using Aspose.Slides;

var loadOptions = new LoadOptions { OnlyLoadDocumentProperties = true };
using var presentation = new Presentation("public-properties-encrypted.pptx", loadOptions);

if (presentation.ProtectionManager.IsOnlyDocumentPropertiesLoaded)
{
    var documentProperties = presentation.DocumentProperties;

    Console.WriteLine("Author: " + documentProperties.Author);
    Console.WriteLine("Title: " + documentProperties.Title);
    Console.WriteLine("Keywords: " + documentProperties.Keywords);
}
else
{
    Console.WriteLine("The presentation was not loaded in document-properties-only mode.");
}

Nella modalità, il contenuto delle diapositive non viene caricato. Diapositive, master, layout, forme, media e altri oggetti della presentazione non sono disponibili. Le applicazioni dovrebbero sempre verificare IProtectionManager.IsOnlyDocumentPropertiesLoaded prima di eseguire un’operazione che richiede l’intero modello ad oggetti della presentazione.

Aggiornare le proprietà di una presentazione crittografata

Per un file PPTX crittografato, una presentazione caricata con LoadOptions.OnlyLoadDocumentProperties è destinata alla lettura dei metadati pubblici. Aspose.Slides non può salvare le proprietà modificate da quell’oggetto contenente solo i metadati perché le proprietà pubbliche devono rimanere coerenti con i dati corrispondenti all’interno della presentazione crittografata. Aggiornare quindi richiede la password di apertura corretta e un caricamento completo.

L’esempio richiede una presentazione PPTX crittografata con proprietà del documento pubbliche e una password di apertura nota. Apre la presentazione completa con LoadOptions.Password, aggiorna le proprietà predefinite pubbliche e salva il risultato. Successivamente utilizza IPresentationInfo.IsEncrypted per verificare che la crittografia sia mantenuta e riapre i metadati pubblici senza password per verificare i nuovi valori :

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

const string inputPath = "public-properties-encrypted.pptx";
const string outputPath = "updated-public-properties-encrypted.pptx";

var loadOptions = new LoadOptions { Password = "open_password" };
using var presentation = new Presentation(inputPath, loadOptions);

var documentProperties = presentation.DocumentProperties;
documentProperties.Title = "Updated Product Roadmap";
documentProperties.Keywords = "roadmap, planning, indexed";

presentation.Save(outputPath, SaveFormat.Pptx);

var presentationInfo = PresentationFactory.Instance.GetPresentationInfo(outputPath);
Console.WriteLine("The presentation is encrypted: " + presentationInfo.IsEncrypted);

var metadataLoadOptions = new LoadOptions { OnlyLoadDocumentProperties = true };
using var metadataPresentation = new Presentation(outputPath, metadataLoadOptions);

if (metadataPresentation.ProtectionManager.IsOnlyDocumentPropertiesLoaded)
{
    Console.WriteLine("Title: " + metadataPresentation.DocumentProperties.Title);
    Console.WriteLine("Keywords: " + metadataPresentation.DocumentProperties.Keywords);
}
else
{
    Console.WriteLine("The presentation was not loaded in document-properties-only mode.");
}

Se a un’applicazione non è consentito decifrare o caricare il contenuto della presentazione, deve considerare le proprietà pubbliche di un file PPTX crittografato come in sola lettura.

Accedere alle proprietà predefinite

L’interfaccia IDocumentProperties espone i metadati predefiniti tramite proprietà tipizzate, tra cui Author, Title e CreatedTime. Questo esempio apre una presentazione esistente e stampa i metadati memorizzati sulla console. I valori dipendono dalla presentazione di input; alcuni campi potrebbero essere vuoti.

using System;
using Aspose.Slides;

using var presentation = new Presentation("AccessBuiltInProperties.pptx");

var documentProperties = presentation.DocumentProperties;

Console.WriteLine("Category: " + documentProperties.Category);
Console.WriteLine("Content status: " + documentProperties.ContentStatus);
Console.WriteLine("Creation date: " + documentProperties.CreatedTime);
Console.WriteLine("Author: " + documentProperties.Author);
Console.WriteLine("Comments: " + documentProperties.Comments);
Console.WriteLine("Keywords: " + documentProperties.Keywords);
Console.WriteLine("Last modified by: " + documentProperties.LastSavedBy);
Console.WriteLine("Manager: " + documentProperties.Manager);
Console.WriteLine("Modified date: " + documentProperties.LastSavedTime);
Console.WriteLine("Presentation format: " + documentProperties.PresentationFormat);
Console.WriteLine("Last print date: " + documentProperties.LastPrinted);
Console.WriteLine("Is shared between producers: " + documentProperties.SharedDoc);
Console.WriteLine("Subject: " + documentProperties.Subject);
Console.WriteLine("Title: " + documentProperties.Title);

Modificare le proprietà predefinite

Per aggiornare i metadati predefiniti, assegna valori alle proprietà scrivibili esposte da IPresentation.DocumentProperties. Questo esempio apre una presentazione esistente, imposta Author, Title, Subject, Comments, e Manager, quindi salva la presentazione aggiornata con Presentation.Save. Il PPTX salvato contiene i nuovi metadati.

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("ModifyBuiltInProperties.pptx");

var documentProperties = presentation.DocumentProperties;

documentProperties.Author = "Aspose.Slides for .NET";
documentProperties.Title = "Manage PowerPoint Presentation Properties";
documentProperties.Subject = "Modify Built-in Properties";
documentProperties.Comments = "Aspose description";
documentProperties.Manager = "Aspose manager";

presentation.Save("DocumentProperties_output.pptx", SaveFormat.Pptx);

Gestire la base dei collegamenti ipertestuali

IDocumentProperties.HyperlinkBase memorizza la base a livello di documento per i collegamenti ipertestuali relativi. Questo è utile quando si sposta una presentazione e i suoi file collegati in un’altra posizione. È separato dall'IHyperlink.ExternalUrl di un singolo collegamento: modificare la base non riscrive gli indirizzi dei collegamenti memorizzati né cambia le destinazioni assolute.

L’esempio richiede una presentazione contenente sia un collegamento relativo, come target.html, sia un collegamento assoluto, come https://example.org/absolute.html. Legge la base esistente, assegna un nuovo indirizzo di base e salva e riapre la presentazione per verificare il valore. Quindi cancella la base con string.Empty e verifica il valore vuoto in un file salvato separatamente. Sostituisci l’indirizzo di base dell’esempio con la posizione dei tuoi file collegati.

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("hyperlinks.pptx");
Console.WriteLine("Original base: " + presentation.DocumentProperties.HyperlinkBase);

const string newBase = "https://example.com/new/";
presentation.DocumentProperties.HyperlinkBase = newBase;
presentation.Save("hyperlinks-updated.pptx", SaveFormat.Pptx);

using var updatedPresentation = new Presentation("hyperlinks-updated.pptx");
Console.WriteLine("Base preserved: " + (updatedPresentation.DocumentProperties.HyperlinkBase == newBase));

updatedPresentation.DocumentProperties.HyperlinkBase = string.Empty;
updatedPresentation.Save("hyperlinks-cleared.pptx", SaveFormat.Pptx);

using var clearedPresentation = new Presentation("hyperlinks-cleared.pptx");
Console.WriteLine("Base cleared: " + (clearedPresentation.DocumentProperties.HyperlinkBase == string.Empty));

I due messaggi di verifica dovrebbero stampare True. L’eliminazione della base lascia intatti gli indirizzi dei singoli collegamenti ipertestuali.

Un collegamento relativo a target.pptx apriva old/target.pptx quando la base puntava alla cartella old. Dopo aver cambiato la base nella cartella new, salvato e riaperto la presentazione, lo stesso collegamento apriva new/target.pptx. Un collegamento assoluto ha continuato ad aprire lo stesso file. Testa i tuoi collegamenti relativi in PowerPoint prima e dopo aver spostato la presentazione o cambiato la sua base.

Aggiungere proprietà personalizzate alla presentazione

Le proprietà personalizzate memorizzano metadati che non hanno un campo predefinito corrispondente. L'indice di IDocumentProperties consente di assegnare un valore tramite il nome della proprietà. Questo esempio crea una presentazione, aggiunge due valori di testo e un valore intero di versione, e salva la presentazione con Presentation.Save. Assegnare un valore a un nome esistente sostituisce il valore di quella proprietà.

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation();

var documentProperties = presentation.DocumentProperties;

documentProperties["Reviewed by"] = "John Smith";
documentProperties["Confidentiality level"] = "Internal";
documentProperties["Document version"] = 2;

presentation.Save("CustomDocumentProperties_output.pptx", SaveFormat.Pptx);

Accedere e modificare le proprietà personalizzate

Questo esempio apre una presentazione contenente proprietà personalizzate e utilizza CountOfCustomProperties per iterare su di esse. GetCustomPropertyName accetta un indice zero-based e restituisce il nome usato dall'indice di IDocumentProperties. L’esempio stampa ogni nome e valore originale, sostituisce ogni valore con una stringa numerata indipendentemente dal tipo originale, e salva le modifiche. Se non ci sono proprietà personalizzate, il ciclo non apporta modifiche.

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("AccessAndModifyProperties.pptx");

var documentProperties = presentation.DocumentProperties;

for (var i = 0; i < documentProperties.CountOfCustomProperties; i++)
{
    var propertyName = documentProperties.GetCustomPropertyName(i);
    var propertyValue = documentProperties[propertyName];

    Console.WriteLine("Custom property name: " + propertyName);
    Console.WriteLine("Custom property value: " + propertyValue);

    documentProperties[propertyName] = "New Value " + (i + 1);
}

presentation.Save("CustomProperties_output.pptx", SaveFormat.Pptx);

Esempio live

Prova l’app online Visualizza e modifica i metadati di PowerPoint per vedere come lavorare con le proprietà del documento usando l’API Aspose.Slides:

Visualizza e modifica i metadati di PowerPoint

FAQ

Come posso rimuovere una proprietà predefinita da una presentazione?

Le proprietà predefinite sono una parte integrante della presentazione e non possono essere rimosse del tutto. Tuttavia, è possibile modificarne i valori o impostarle a vuoto se la specifica proprietà lo consente.

Cosa succede se aggiungo una proprietà personalizzata che esiste già?

Se aggiungi una proprietà personalizzata che esiste già, il suo valore esistente verrà sovrascritto con quello nuovo. Non è necessario rimuovere o verificare la proprietà in anticipo, poiché Aspose.Slides aggiorna automaticamente il valore della proprietà.

Posso accedere alle proprietà della presentazione senza caricare completamente la presentazione?

Sì. Usa PresentationFactory.GetPresentationInfo e poi IPresentationInfo.ReadDocumentProperties per leggere i metadati del documento memorizzati senza creare un’istanza Presentation. Vedi Build a Lightweight Presentation Inventory per un esempio completo di reportistica e per le limitazioni specifiche del formato.

Posso leggere le proprietà pubbliche di una presentazione crittografata senza la sua password di apertura?

Sì. La presentazione deve essere stata crittografata con IProtectionManager.EncryptDocumentProperties impostato su false, e deve essere caricata con LoadOptions.OnlyLoadDocumentProperties impostato su true.

Posso aggiornare un file PPTX crittografato in modalità solo proprietà del documento?

No. I dati delle proprietà pubbliche e crittografate devono rimanere coerenti, quindi aggiornare un file PPTX crittografato richiede il caricamento completo della presentazione con la password di apertura corretta.