Enum UnresolvedPlaceholderAction

Namespace

DocWright.Dom.Editing

Assembly

DocWright.Dom.dll

What to do with a placeholder the data supplies no value for.

public enum UnresolvedPlaceholderAction

Fields

Leave = 0

Leave the placeholder in the document exactly as it stands. The default.

Clear = 1

Remove the placeholder, putting nothing in its place.

Throw = 2

Throw InvalidDocumentException naming the placeholder (DXP1004).

Remarks

A placeholder whose key is present but whose value is null is not unresolved: it substitutes as empty, the same way a null merges as empty in mail merge. The distinction matters because a missing key is nearly always a template typo, while a null value is ordinary data.