영어로 읽기

다음을 통해 공유


컴파일러 경고(수준 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>
{
}