PdfPortfolioFileCollectionAdd Method

Adds a new PdfFileSpecification with the EmbeddedFile copied from the resource specified by the filePath to EmbeddedFiles under the PdfPortfolio (root file) or parent PdfPortfolioFolder.

Namespace: SautinSoft.Pdf.Portfolios
Assembly: SautinSoft.Pdf (in SautinSoft.Pdf.dll) Version: 2025.10.22

Syntax

public PdfFileSpecification Add(
	string filePath
)

Public Function Add ( 
	filePath As String
) As PdfFileSpecification

filePath String: The location of the resource copied to the EmbeddedFile of a newly added PdfFileSpecification. This value is also used to resolve the Name and a key in the EmbeddedFiles of a newly added PdfFileSpecification.

PdfFileSpecification
A newly created PdfFileSpecification with the EmbeddedFile copied from the resource specified by the filePath added to the EmbeddedFiles under the PdfPortfolio (root file) or parent PdfPortfolioFolder.

Exceptions

Exception	Condition
ArgumentNullException	filePath is or Empty.
ArgumentException	A PdfFileSpecification with the same key already exists in the EmbeddedFiles.
NotSupportedException	The parent PdfPortfolioFolder is not in the PDF portfolio.

Remarks

The EmbeddedFile's Size, CreationDate, ModificationDate, and MediaType properties are automatically set, if they can be resolved from the resource specified by the filePath.