컴파일러 경고(수준 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>
{
}
GitHub에서 Microsoft와 공동 작업
이 콘텐츠의 원본은 GitHub에서 찾을 수 있으며, 여기서 문제와 끌어오기 요청을 만들고 검토할 수도 있습니다. 자세한 내용은 참여자 가이드를 참조하세요.
.NET 피드백
.NET은(는) 오픈 소스 프로젝트입니다. 다음 링크를 선택하여 피드백을 제공해 주세요.