IL3002: Ne hívja meg a "RequiresAssemblyFilesAttribute" felirattal ellátott tagokat egyetlen fájlként való közzétételkor.
Érték | |
---|---|
Szabályazonosító | IL3002 |
Kategória | SingleFile |
A javítás kompatibilitástörő vagy nem törhető | Nem törhető |
Ok
Ha egyetlen fájlként tesz közzé egy alkalmazást (például ha egy projektben beállítja a PublishSingleFile
tulajdonságot true
), az RequiresAssemblyFilesAttribute
attribútummal jegyzett tagok meghívása nem egyfájlos kompatibilis. Ezek a hívások nem kompatibilisek, mert az attribútummal jegyzett tagoknak lemezen kell lenniük szerelvényfájloknak, az egy fájlból álló alkalmazásba beágyazott szerelvények pedig memóriabetöltést igényelnek.
Példa:
[RequiresAssemblyFiles(Message="Use 'MethodFriendlyToSingleFile' instead", Url="http://help/assemblyfiles")]
void MethodWithAssemblyFilesUsage()
{
}
void TestMethod()
{
// IL3002: Using member 'MethodWithAssemblyFilesUsage' which has 'RequiresAssemblyFilesAttribute'
// can break functionality when embedded in a single-file app. Use 'MethodFriendlyToSingleFile' instead. http://help/assemblyfiles
MethodWithAssemblyFilesUsage();
}
Szabálysértések kijavítása
A "RequiresAssemblyFilesAttribute" attribútummal jegyzett tagoknak van egy üzenetük, amely hasznos információkat nyújt azoknak a felhasználóknak, akik egyetlen fájlként tesznek közzé. Fontolja meg a meglévő kódnak az attribútum üzenetéhez való igazítását vagy a szabálysértő hívás eltávolítását.
Mikor kell letiltani a figyelmeztetéseket?
Célszerű mellőzni a figyelmeztetést, ha a meglévő kódot a "RequiresAssemblyFilesAttribute" attribútum üzenetében ismertetett javaslathoz igazították.