CA1017: Szerelvények megjelölése a ComVisibleAttribute használatával
Tulajdonság | Érték |
---|---|
Szabályazonosító | CA1017 |
Cím | Szerelvények megjelölése a ComVisibleAttribute használatával |
Kategória | Design |
A javítás kompatibilitástörő vagy nem törik | Nem törés |
Alapértelmezés szerint engedélyezve a .NET 8-ban | Nem |
Ok
A szerelvényre nincs alkalmazva az System.Runtime.InteropServices.ComVisibleAttribute attribútum.
Szabály leírása
Az ComVisibleAttribute attribútum határozza meg, hogy a COM-ügyfelek hogyan férnek hozzá a felügyelt kódhoz. A jó kialakítás azt diktálja, hogy a szerelvények explicit módon jelezzék a COM láthatóságát. A COM láthatósága beállítható egy teljes szerelvényhez, majd felül lehet bírálni az egyes típusok és típustagok esetében. Ha az attribútum nem található, a szerelvény tartalma látható a COM-ügyfelek számára.
Szabálysértések kijavítása
A szabály megsértésének kijavításához adja hozzá az attribútumot a szerelvényhez. Ha nem szeretné, hogy a szerelvény látható legyen a COM-ügyfelek számára, alkalmazza az attribútumot, és állítsa az értékét a következőre false
: .
Mikor kell letiltani a figyelmeztetéseket?
Ne tiltsa el a szabály figyelmeztetését. Ha azt szeretné, hogy a szerelvény látható legyen, alkalmazza az attribútumot, és állítsa az értékét a következőre true
: .
Példa
Az alábbi példa egy olyan szerelvényt mutat be, amely az ComVisibleAttribute attribútumot alkalmazva megakadályozza, hogy látható legyen a COM-ügyfelek számára.
<Assembly: System.Runtime.InteropServices.ComVisible(False)>
Namespace DesignLibrary
End Namespace
[assembly: System.Runtime.InteropServices.ComVisible(false)]
namespace DesignLibrary {}