Прочитать на английском

Поделиться через


Предупреждение компилятора (уровень 1) CS1723

Xml-комментарий имеет атрибут cref атрибута атрибута, который ссылается на параметр типа

Эта ошибка создается для xml-комментария в случае использования <тега see/> tag с перекрестной ссылкой (cref) на параметр типа вместо существующего типа (определяемого пользователем или встроенного) в коде. Невозможно связать с атрибутом универсальных типов, так как в момент создания документации будущий тип, указанный как атрибут, еще не известен.

Для решения этой проблемы <следует использовать typeparamref/> tag.

Пример

В следующем примере содержится комментарий, создающий CS1723, а также ссылку, которая может быть связана правильно.

C#
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

C#
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>
{
}