Repository navigation
v0.54.0
0.54.0 (2026-09-02)
⚠ BREAKING CHANGES
-
Core:
DocxForm.Fillrefuses to fill a content control the document locks.
A fill that would change a locked control now throwsInvalidOperationExceptionand writes
nothing; the document you pass in is untouched, and aStreamoverload writes zero bytes to its
destination.It previously succeeded - and left the
w:lockin place, so the result declared the control
protected while its content had been replaced. That file contradicted itself, no reader could see
it, and the caller had no way to detect it afterwards. Measured againstsdtContentLocked,
sdtLockedandcontentLocked.What to do: remove the lock in Word, or leave that control out of the values you pass.
Filling other controls in a document that also contains a locked one is unaffected and still
works - which is the ordinary case for a template that locks its headings.This is why 0.54.0 is a minor bump rather than a patch. See Migrating in the README.
Locks are not read, reported or removed by this change.
DocxFormFieldstill exposesKey
andValuealone; a caller cannot yet tell a locked control from an editable one without
attempting the fill.