Compilerwaarschuwing (niveau 1) CS1723
XML-opmerking heeft cref kenmerk 'kenmerk' die verwijst naar een typeparameter
Deze fout wordt gegenereerd voor een XML-opmerking in het geval van het gebruik van een <see/> tag met kruisverwijzing (cref) naar een typeparameter in plaats van het bestaande type (of door de gebruiker gedefinieerd of ingebouwd) in de code. Het is onmogelijk om een koppeling te maken naar 'kenmerk' van algemene typen, omdat op het moment van het maken van de documentatie het toekomstige type dat is opgegeven als 'kenmerk' nog niet bekend is.
U kunt dit probleem oplossen <door typeparamref/> tag te gebruiken.
Het volgende voorbeeld bevat een opmerking die CS1723 genereert, evenals een verwijzing die correct kan worden gekoppeld.
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 dit voorbeeld ziet u hoe u zowel het algemene type T
als de reeds bekende door de gebruiker gedefinieerde type correct koppelt 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>
{
}
.NET-feedback
.NET is een open source project. Selecteer een koppeling om feedback te geven: