Aviso do compilador (nível 1) CS1723

O comentário XML tem o atributo cref 'attribute' que se refere a um parâmetro de tipo.

Esse erro é gerado para um comentário XML no caso de usar uma tag <see> com referência cruzada (cref) para um parâmetro de tipo em vez de um tipo existente (seja definido pelo usuário ou interno) no código. É impossível vincular ao 'atributo' de tipos genéricos, pois, no momento da criação da documentação, o tipo futuro a ser fornecido como 'atributo' ainda não está determinado.

Para resolver esse problema, use a <typeparamref> marca.

Example

O exemplo a seguir contém um comentário que gera CS1723, bem como uma referência que pode ser vinculada corretamente.

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

O exemplo a seguir mostra como vincular corretamente tanto o tipo genérico T quanto o tipo já conhecido definido pelo usuário 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>
{
}