René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"`SwitchParameter.IsPresent` documentation does not match actual behavior when parameter is explicitly set to `false`","articleBody":"The inline documentation for the `IsPresent` property states that it returns `true` if the parameter was specified on the command line, and `false` otherwise:\n\n```cs\n/// \u003csummary\u003e\n/// Returns true if the parameter was specified on the command line, false otherwise.\n/// \u003c/summary\u003e\n/// \u003cvalue\u003eTrue if the parameter was specified, false otherwise\u003c/value\u003e\npublic bool IsPresent\n{\n    get { return _isPresent; }\n}\n```\n\nHowever, this description is inaccurate. The property returns `false` when a parameter is explicitly specified on the command line with a value of `false`.\n\n### Proposed Resolution\n\nEither:\n1. **Clarify documentation** to specify that the property returns `false` both when the parameter is _not specified_ and when it is _explicitly specified with a value of `false`_; or\n1. **Adjust implementation** so that `IsPresent` returns `true` whenever the parameter is explicitly supplied, regardless of its value.\n1. **Deprecate** `IsPresent` in favor of a clearer or more accurately named property that distinguishes between 'parameter presence' and 'parameter value'.","author":{"url":"https://github.com/xtqqczze","@type":"Person","name":"xtqqczze"},"datePublished":"2025-10-05T15:18:49.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":2},"url":"https://github.com/26149/PowerShell/issues/26149"}