Mention `ParameterInfo.Name` is null when inspecting optimized assembly

[gewarren]

---

Issue moved from MicrosoftDocs/feedback#3981

• Please respond to @elringus.

---

From @elringus on Tuesday, January 23, 2024 3:00:40 PM

Currently, docs for ParameterInfo.Name mention that the value is null when accessed from a return parameter: https://learn.microsoft.com/en-us/dotnet/api/system.reflection.parameterinfo.name?view=net-8.0#remarks

I've spent quite some time debugging before stumbled upon this issue: dotnet/runtime#73188 (comment) Which explains that it's also null when inspecting an optimized assembly.

Please add a remark to the docs about this corner case.

I couldn't figure out the best area label to add to this issue. If you have write-permissions please help me learn by adding exactly one area label.

[colejohnson66]

Does it make sense for this warning on "null" values to be in the remarks and not the "property value" area? I would expect a comment on "null" properties to be in the main documentation, not down in the remarks area.

[gewarren]

Does it make sense for this warning on "null" values to be in the remarks and not the "property value" area? I would expect a comment on "null" properties to be in the main documentation, not down in the remarks area.

Yeah, it could be added to the property value section instead.