Предупреждение компилятора (уровень 1) CS1723
Xml-комментарий имеет атрибут cref атрибута атрибута, который ссылается на параметр типа
Эта ошибка создается для xml-комментария в случае использования <тега see/> tag с перекрестной ссылкой (cref) на параметр типа вместо существующего типа (определяемого пользователем или встроенного) в коде. Невозможно связать с атрибутом универсальных типов, так как в момент создания документации будущий тип, указанный как атрибут, еще не известен.
Для решения этой проблемы <следует использовать typeparamref/> tag.
В следующем примере содержится комментарий, создающий 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>
{
}
Отзыв о .NET
.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв: