Compilerwarnung (Stufe 1) CS1723

Der XML-Kommentar enthält ein cref-Attribut „“, das auf einen Typparameter verweist.

Dieser Fehler wird für einen XML-Kommentar generiert, wenn im Code ein Tag vom Typ <see/> mit Querverweis (cross reference, cref) auf einen Typparameter anstelle des vorhandenen Typs (benutzerdefiniert oder integriert) verwendet wird. Eine Verknüpfung mit „“ eines generischen Typs ist nicht möglich, da zum Zeitpunkt der Erstellung der Dokumentation der zukünftige, als „“ angegebene Typ noch nicht bekannt ist.

Verwenden Sie zur Behebung dieses Problems das Tag <typeparamref/>.

Beispiel

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

In diesem Beispiel wird gezeigt, wie sowohl der generische Typ T als auch der bereits bekannte benutzerdefinierte Typ Point korrekt verknüpft wird.

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