[electricessence]

AddParams(object) on a text command: the article said every member is sent; the code sends only the members the text uses.

The question

• Can a caller safely hand AddParams an object that has more members than the command needs? Yes, when the command's parameter names are known: only the members the command declares are sent, and an unused member is ignored. Documented for a stored procedure already; this pins and documents the text-command case too.

What was wrong

• expressive-commands.md said that without the procedure's names, "a text command, another provider", every member is sent. A text command that has @name markers is matched against them the same way a procedure's declared names are, so a member with no marker is not sent. Every member is sent, named as written, only when the names are not known: a stored procedure on a provider that cannot report its parameter names, or a text command with no @name marker.

What changes

• The sentence is corrected.
• A new test pins the behavior: select 1 where a = @id and b = @region with AddParams(new { Id = 7, Region = "west", Unrelated = true }) sends @id and @region, and Unrelated is not sent.
• No code changes.

Checks

• Release and Debug builds: 0 warnings, 0 errors. Tests: 9678 of 9678 pass in both. Samples: 103 of 103 checks pass. Style and analyzers: 0 findings. DocFX: 0 warnings.

🤖 Generated with Claude Code