IL3002: Vermeiden Sie das Aufrufen von Membern, die mit „RequiresAssemblyFilesAttribute“ kommentiert sind, wenn sie als einzelne Datei veröffentlicht werden.

Ursache

Wenn Sie eine App als Einzeldatei veröffentlichen (z. B. durch Festlegen der Eigenschaft PublishSingleFile in einem Projekt auf true), ist das Aufrufen von Membern, die mit dem Attribut RequiresAssemblyFilesAttribute kommentiert sind, nicht mit Einzeldateien kompatibel. Diese Aufrufe sind nicht kompatibel, da Member, die mit diesem Attribut versehen sind, Assemblydateien auf dem Datenträger benötigen und die in eine Einzeldatei-App eingebetteten Assemblys werden in den Arbeitsspeicher geladen.

Beispiel:

[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();
}

Behandeln von Verstößen

Member, die mit dem Attribut „RequiresAssemblyFilesAttribute“ kommentiert sind, verfügen über eine Meldung mit nützlichen Informationen für Benutzer, die eine Veröffentlichung als einzelne Datei vornehmen. Erwägen Sie, vorhandenen Code an die Meldung des Attributs anzupassen oder den verstoßenden Aufruf zu entfernen.

Wann sollten Warnungen unterdrückt werden?

Es ist sinnvoll, die Warnung zu unterdrücken, wenn der vorhandene Code an die Empfehlung angepasst wurde, die in der Meldung des Attributs „RequiresAssemblyFilesAttribute“ beschrieben ist.