Compartir a través de


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".