IL3002: Vyhněte se volání členů anotovaných pomocí "RequiresAssemblyFilesAttribute" při publikování jako jednoho souboru.
Hodnota | |
---|---|
ID pravidla | IL3002 |
Kategorie | SingleFile |
Oprava způsobující chybu nebo přerušení | Pevných |
Příčina
Když publikujete aplikaci jako jeden soubor (například nastavením PublishSingleFile
vlastnosti do true
projektu), volání členů s poznámkami s atributem RequiresAssemblyFilesAttribute
není kompatibilní s jedním souborem. Tato volání nejsou kompatibilní, protože členy s tímto atributem vyžadují, aby byly soubory sestavení na disku a sestavení vložená do aplikace s jedním souborem jsou načtena do paměti.
Příklad:
[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();
}
Jak opravit porušení
Členové anotace s atributem RequiresAssemblyFilesAttribute mají zprávu určenou k poskytnutí užitečných informací uživatelům, kteří publikují jako jeden soubor. Zvažte přizpůsobení existujícího kódu ke zprávě atributu nebo odebrání porušení volání.
Kdy potlačit upozornění
Je vhodné potlačit upozornění, pokud byl existující kód upraven na doporučení popsaného ve zprávě atributu RequiresAssemblyFilesAttribute.