Compilerwarnung (Ebene 1) CS1723

DER XML-Kommentar weist das Cref-Attribut "Attribut" auf, das sich auf einen Typparameter bezieht.

Dieser Fehler wird für einen XML-Kommentar generiert, wenn ein <see> Tag mit Querverweis (Cref) zu einem Typparameter anstelle des vorhandenen Typs (ob benutzerdefinierte oder integrierte) im Code verwendet wird. Es ist unmöglich, eine Verknüpfung mit dem Attribut von generischen Typen herzustellen, da zum Zeitpunkt der Erstellung der Dokumentation der zukünftige Typ, der als "Attribut" angegeben wird, noch nicht bekannt ist.

Um dieses Problem zu beheben, verwenden Sie das <typeparamref> Tag.

Example

Das folgende Beispiel enthält einen Kommentar, der CS1723 generiert, sowie einen Verweis, der ordnungsgemäß verknüpft werden kann.

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

Das nächste Beispiel zeigt, wie sowohl der generische Typ T als auch der bereits bekannte benutzerdefinierte Point korrekt verknüpft werden können.

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