Leggere in inglese

Condividi tramite


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/>.

Esempio

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