Here’s what happened; I was working on some code and assumed (yes, my bad) that the return value would be a Null object, when in fact the returned object is never null, and the success/failure is in a member.
As it turns out the behavior is documented in the XML Comment block on the function I was using, however, VS2k10 doesn’t show the <returns>...</returns> block, only the <summary>...</summary> block.
Is there a way to adjust VS2k10 to show the <returns>... comments as well?
Unfortunately, we never show
<returns>in Quick Info or Parameter Info. You have to view it in Object Browser.Another alternative is to position the caret on the method name that you want to view
<returns>for, and hit F12 (or whatever key is mapped to the Go To Definition command,Edit.GoToDefinition). This will open “Metadata As Source” window, which will contain the full method signature along all XML documentation comments, including<returns>.