Portfolios

edit

Create a portfolio

A portfolio is a document whose embedded files viewers show as a list, instead of the pages. The columns are the fields of its schema, and each file has a value for each field:

var report = document.EmbeddedFiles.Add("report.pdf", "%PDF-1.7"u8);
var data = document.EmbeddedFiles.Add("data.csv", "a,b"u8);
var portfolio = document.CreatePortfolio();
portfolio.View = PdfPortfolioView.Details;
portfolio.InitialFile = "report.pdf";
portfolio.AddField("name", "Name", PdfPortfolioFieldType.FileName);
portfolio.AddField("owner", "Owner");
portfolio.AddField("reviewed", "Reviewed", PdfPortfolioFieldType.Date);
portfolio.SetSort(ascending: true, "owner", "name");
report.SetPortfolioValue("owner", "Finance");
report.SetPortfolioValue("reviewed", new DateTimeOffset(2026, 1, 15, 0, 0, 0, TimeSpan.Zero));
data.SetPortfolioValue("owner", "IT");

Read a portfolio

PdfDocument.Portfolio is null when the document is not a portfolio. The folders of a portfolio are read from RootFolder: each folder has a name, an identifier, and its sub-folders. The tree is bounded: a folder reached twice ends a list, and the depth is limited to 32.