PdfEmbeddedFileSpecificationTreeAddEmpty Method

Add a new PdfFileSpecification with the specified name and an empty EmbeddedFile.

Namespace: SautinSoft.Pdf
Assembly: SautinSoft.Pdf (in SautinSoft.Pdf.dll) Version: 2025.11.10

Syntax

public KeyValuePair<PdfString, PdfFileSpecification> AddEmpty(
	string fileSpecificationName
)

Public Function AddEmpty ( 
	fileSpecificationName As String
) As KeyValuePair(Of PdfString, PdfFileSpecification)

fileSpecificationName String: The name of a newly added PdfFileSpecification. This value is also used to resolve a key in the PdfEmbeddedFileSpecificationTree of a newly added PdfFileSpecification.

KeyValuePairPdfString, PdfFileSpecification
A newly created PdfFileSpecification with the specified name and an empty EmbeddedFile added to the PdfEmbeddedFileSpecificationTree under the returned key.

Exceptions

Exception	Condition
ArgumentNullException	fileSpecificationName is or Empty.
ArgumentException	A PdfFileSpecification with the same key already exists in the PdfEmbeddedFileSpecificationTree.