Avviso del compilatore (livello 1) CS1723

Il commento XML ha l'attributo cref 'attribute' che fa riferimento a un parametro di tipo.

Questo errore viene generato per un commento XML in caso di uso di un <see> tag con riferimento incrociato (cref) a un parametro di tipo anziché al tipo esistente (definito dall'utente o predefinito) nel codice. Non è possibile collegarsi a 'attribute' di tipi generici perché al momento della creazione della documentazione il tipo futuro dato come 'attribute' non è ancora noto.

Per risolvere questo problema, usare il <typeparamref> tag .

Example

L'esempio seguente contiene un commento che genera 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>
{
}

Nell'esempio seguente viene illustrato come collegare correttamente sia il tipo T generico sia 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>
{
}