컴파일러 경고(수준 1) CS1723

XML 주석에는 형식 매개 변수를 참조하는 cref 특성 'attribute'가 있습니다.

이 오류는 코드에서 기존 형식(사용자 정의 또는 기본 제공)이 아닌 형식 매개 변수에 상호 참조(cref)가 있는 태그를 사용하는 <see> 경우 XML 주석에 대해 생성됩니다. 설명서를 만드는 시점에서 '특성'으로 지정된 미래 형식을 아직 알 수 없으므로 제네릭 형식의 '특성'에 연결하는 것은 불가능합니다.

이 문제를 해결하려면 태그를 <typeparamref> 사용합니다.

예시

다음 예제에는 CS1723을 생성하는 주석과 올바르게 연결할 수 있는 참조가 포함되어 있습니다.

public class Point
{
}

// compile with: /t:library /doc:filename.XML
///<summary>A generic list class.</summary>
///uses <see cref="T" />      // CS1723
///and <see cref="Point" />   // No warning
public class List<T, Point>
{
}

다음 예제에서는 제네릭 형식과 이미 알려진 사용자 정의 T형식 Point 을 모두 올바르게 연결하는 방법을 보여 있습니다.

public class Point
{
}

// compile with: /t:library /doc:filename.XML
///<summary>A generic list class.</summary>
///uses <typeparamref name="T" />  // No warning
///and <see cref="Point" />        // No warning
public class List<T, Point>
{
}