How to refer to an extension method of a generic class in XML comments

Question

What is the proper XML-comment syntax to refer to the SingleOrDefault extension method on the IEnumerable interface?

My latest attempt is:

<see cref="IEnumerable{T}.SingleOrDefault{T}()"/>

The warning is:

XML comment on 'yourMethod' has cref attribute 'IEnumerable.SingleOrDefault()' that could not be resolved

score 10 · Accepted Answer · answered May 02 '14 at 22:42

10

You were close. The extension method belongs to the Enumerable class. Try:

<see cref="Enumerable.SingleOrDefault{TSource}(IEnumerable{TSource})"/>

answered May 02 '14 at 22:42

Ed Chapel

Thanks. I had tried all sorts of stuff, and it was getting quite annoying :) I hate that it was a simple oversight on my part, but I'm glad it's done. – harley.333 May 03 '14 at 17:10

1 Answers1