IL3002: Evite llamar a miembros anotados con "RequiresAssemblyFilesAttribute" en una publicación como un archivo único.
Valor | |
---|---|
Identificador de la regla | IL3002 |
Categoría | SingleFile |
La corrección interrumpe o no interrumpe | No importante |
Causa
Al publicar una aplicación como un único archivo (por ejemplo, estableciendo la propiedad PublishSingleFile
en true
en un proyecto), llamar a los miembros anotados con el atributo RequiresAssemblyFilesAttribute
no es compatible con un solo archivo. Estas llamadas no son compatibles porque los miembros anotados con este atributo requieren que los archivos de ensamblado estén en el disco y los ensamblados incrustados en una aplicación de un solo archivo están cargados en memoria.
Ejemplo:
[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();
}
Cómo corregir infracciones
Los miembros anotados con el atributo "RequiresAssemblyFilesAttribute" tienen un mensaje destinado a proporcionar información útil a los usuarios que publican como un archivo único. Considere la posibilidad de adaptar el código existente al mensaje del atributo o de quitar la llamada infractora.
Cuándo suprimir las advertencias
Se puede suprimir la advertencia cuando el código existente se ha adaptado a la recomendación descrita en el mensaje del atributo "RequiresAssemblyFilesAttribute".