ComVisibleAttribute Klasa

Definicja

Przestrzeń nazw:

System.Runtime.InteropServices

Zestawy:

netstandard.dll, System.Runtime.dll

Źródło:

ComVisibleAttribute.cs

Steruje ułatwieniami dostępu poszczególnych typów zarządzanych lub składowych lub wszystkich typów w zestawie do modelu COM.

C#

[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Delegate | System.AttributeTargets.Enum | System.AttributeTargets.Field | System.AttributeTargets.Interface | System.AttributeTargets.Method | System.AttributeTargets.Property | System.AttributeTargets.Struct, Inherited=false)]
public sealed class ComVisibleAttribute : Attribute

Dziedziczenie

Object

Attribute

ComVisibleAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

W poniższym przykładzie pokazano, jak można kontrolować widoczność do modelu COM klasy, aby jego składowe nie są niewidoczne. Ustawiając wartość falseComVisibleAttribute na włączone MyClass(SampleClassw przykładzie języka Visual Basic) i false w systemach MyMethod i MyPropertymożna uniknąć przypadkowo uwidaczniania elementów członkowskich do modelu COM przez dziedziczenie.

C#

using System.Runtime.InteropServices;

[ComVisible(false)]
class MyClass
{
   public MyClass()
   {
      //Insert code here.
   }

   [ComVisible(false)]
   public int MyMethod(string param)
   {
      return 0;
   }

   public bool MyOtherMethod()
   {
      return true;
   }

   [ComVisible(false)]
   public int MyProperty
   {
      get
      {
         return MyProperty;
      }
   }
}

Uwagi

Ten atrybut można zastosować do zestawów, interfejsów, klas, struktur, delegatów, wyliczenia, pól, metod, akcesorów zdarzeń lub właściwości.

Wartość domyślna to true, która wskazuje, że typ zarządzany jest widoczny dla modelu COM. Ten atrybut nie jest potrzebny do udostępniania publicznych zestawów i typów zarządzanych; są one domyślnie widoczne dla modelu COM. Widoczne mogą być tylko public typy. Nie można użyć atrybutu , aby w inny sposób internal lub protected typ był widoczny dla modelu COM lub aby elementy członkowskie nienadzornego typu były widoczne.

Ustawienie atrybutu na false wartość w zestawie powoduje ukrycie wszystkich public typów w zestawie. Można selektywnie tworzyć typy w zestawie, ustawiając poszczególne typy na true. Ustawienie atrybutu na false określony typ powoduje ukrycie tego typu i jego elementów członkowskich. Nie można jednak ustawić elementów członkowskich typu widocznego, jeśli typ jest niewidoczny. Ustawienie atrybutu na false typ uniemożliwia eksportowanie tego typu do biblioteki typów; klasy nie są zarejestrowane; interfejsy nigdy nie reagują na niezarządzane QueryInterface wywołania.

Chyba że jawnie ustawisz klasę i jej składowe na false, dziedziczone klasy mogą być narażone na składowe klasy bazowej COM, które są niewidoczne w oryginalnej klasie. Jeśli na przykład ustawisz wartość ClassA false i nie zastosujesz atrybutu do jego składowych, klasa i jego składowe są niewidoczne dla modelu COM. Jeśli jednak utworzysz klasę ClassB z klasy ClassA i wyeksportowasz klasę CLASSB do modelu COM, składowe klasy ClassA staną się widocznymi elementami członkowskimi klasy bazowej ClassB.

Aby uzyskać szczegółowy opis procesu eksportowania, zobacz Podsumowanie konwersji zestawu do biblioteki typów.

Konstruktory

ComVisibleAttribute(Boolean)

Inicjuje nowe wystąpienie klasy ComVisibleAttribute.

Właściwości

TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego elementu Attribute. (Odziedziczone po Attribute)
Value	Pobiera wartość wskazującą, czy typ COM jest widoczny.

Metody

Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi. (Odziedziczone po Attribute)
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
IsDefaultAttribute()	W przypadku zastąpienia w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	W przypadku zastąpienia w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Dotyczy

Zobacz też

• Tlbexp.exe (eksporter biblioteki typów)