Avviso del compilatore (livello 1) CS1723
Il commento XML contiene l'attributo cref 'attribute' che fa riferimento a un parametro di tipo
Questo errore viene generato per un commento XML in caso di utilizzo di un tag <see/> con riferimento incrociato (cref) a un parametro di tipo anziché al tipo esistente (definito dall'utente o predefinito) nel codice. Non è possibile collegarsi ad 'attribute' di tipi generici perché al momento della creazione della documentazione il tipo futuro fornito come 'attribute' non è ancora noto.
Per risolvere questo problema, è necessario usare il tag <typeparamref/>.
L'esempio seguente contiene un commento che genera l’avviso CS1723 e un riferimento che può essere collegato correttamente.
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>
{
}
In questo esempio viene illustrato come collegare correttamente sia il tipo generico T
che quello già noto definito dall'utente 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>
{
}
Feedback su .NET
.NET è un progetto di open source. Selezionare un collegamento per fornire feedback: