은이 같은 일반적인 유형/메서드 정의를 참조 할 수 있습니다XML 문서에서 일반적인 매개 변수 인수를 표시하는 방법
/// <summary>
/// Takes a <see cref="Func{Int32}"/>.
/// </summary>
public void Method(Func<int> func) { }
ReSharper에서/생성 된 도움말 파일을 Func<TResult>라고합니다.
첫 번째 예에서는 유형으로 cref 속성의 유형을 지정합니다. 이것은 System 네임 스페이스의 유형과 정확히 일치합니다. 해당 유형의 문서에 대한 링크 (예 : Func<TResult>)를 만들어야합니다. 쉽게 찾아서 연결할 수 있습니다. 이것은 하나의 유형에 대한 하나의 링크를 생성합니다.
두 번째 예에서 Func<Int32> 유형을 찾으면 실제로 가리킬 수있는 문서 유형이 아닙니다. System 네임 스페이스의 형식은 generic이며 매개 변수를 사용합니다. 정확히 일치하는 것으로 생각하지 않을 수도 있지만 파서는 Int32이 type 매개 변수에 사용하는 이름이고 System 네임 스페이스에서 쉽게 찾을 수있는 유형을 가리키고 있다고 가정합니다. 다시 말하지만, 이것은 System 네임 스페이스에서 실제로 찾을 수있는 하나의 유형에 대한 하나의 링크를 생성합니다.
Enumerable.Sum 참조 페이지 에서처럼 두 가지 유형에 대한 두 개의 링크를 사용하는 참조를 만들고 싶을 수도 있습니다. 이 방법의 경우,
public static int Sum<TSource>(
this IEnumerable<TSource> source,
Func<TSource,int> selector
)
그들이 두 종류에 대한 참조를, 하나가 아닙니다. 링크 중 하나는 위임 그룹유형 : System.Func < TSource, Int32>
여기
System.Func에 대한 참조 인 것처럼 보이지만 (다시 언급 할만한 문서 유형은 아닙니다.) 실제로는
System.Func<T,TResult> 대리인의 설명서를 가리 킵니다. 다른 링크는
System.Int32입니다.
더 공식적으로 볼 수 있습니다. XML은 컴파일러 검증을 통과하고 그러나, 나는 그 대부분의 템플릿에 표시하는 방법을 모르는
<see cref="T:System.Func{T:System.Int32}"/>
을 사용하는 경우 변경되지 않습니다. Entity Framework 소스 코드를 문서화하는 데 사용됩니다. 예를 들어 (잘 표시되지 않음) System.Data.Entity.Core.Common.CommandTrees.ExpressionBuilder namespace에 대한 설명서를 볼 수 있습니다.
는 또한 본 그것은 XML, 컴파일러 구문 검증을 통과이 생산 마크 업으로가는 정중하고 만 표시 할 수있는 템플릿을 무시하고, 다시
<see cref="T:System.Func < T:System.Int32 >"/>
그래서 내가하려고하는 일을 할 수있는 방법이 없습니다 (어쩌면 다른 속성으로)? –
나는 당신이하고 싶은 생각을하는 방법을 보여주기 위해 나의 대답을 업데이트했다. –