CA1017: Označte sestavení pomocí atributu ComVisibleAttribute

Vlastnost Hodnota
ID pravidla CA1017
Název Označte sestavení pomocí ComVisibleAttribute
Kategorie Návrh
Oprava, která může být destruktivní nebo nedestruktivní Nezlomitelný
Povoleno ve výchozím nastavení v .NET 10 Ne
Příslušné jazyky C# a Visual Basic

Příčina

Sestavení nemá atribut System.Runtime.InteropServices.ComVisibleAttribute aplikovaný na něj.

Popis pravidla

Atribut ComVisibleAttribute určuje, jak klienti MODELU COM přistupují ke spravovanému kódu. Dobrý návrh vyžaduje, aby sestavení explicitně uvedla viditelnost COM. Viditelnost COM lze nastavit pro celou sestavu a pak přepsat pro jednotlivé typy a členy typu. Pokud atribut není přítomen, obsah sestavení je viditelný pro COM klienty.

Jak opravit porušení

Chcete-li opravit porušení tohoto pravidla, přidejte atribut do sestavení. Pokud nechcete, aby sestavení bylo viditelné pro klienty MODELU COM, použijte atribut a nastavte jeho hodnotu na false.

Kdy potlačit upozornění

Nepotlačujte upozornění na toto pravidlo. Pokud chcete, aby bylo sestavení viditelné, použijte atribut a nastavte jeho hodnotu na true.

Příklad

Následující příklad ukazuje sestavení, které má ComVisibleAttribute atribut použit k tomu, aby zabránil jeho zobrazení klientům COM.

<Assembly: System.Runtime.InteropServices.ComVisible(False)>
Namespace DesignLibrary
End Namespace
[assembly: System.Runtime.InteropServices.ComVisible(false)]
namespace DesignLibrary {}

Viz také