Ler em inglês

Compartilhar via


Aviso do compilador (nível 1) CS1723

O comentário XML tem um atributo cref 'atributo' que faz referência a um parâmetro de tipo

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

Para resolver esse problema, a marca <typeparamref/> deve ser usada.

Exemplo

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

Este exemplo mostra como vincular corretamente o tipo genérico T e o Point definido pelo usuário já conhecido

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