ComVisibleAttribute Classe

Definizione

Spazio dei nomi:

System.Runtime.InteropServices

Assembly:

System.Runtime.dll

Origine:

ComVisibleAttribute.cs

Controlla l'accessibilità di un singolo tipo gestito o un membro, oppure di tutti i tipi all'interno di un assembly, per COM.

public ref class ComVisibleAttribute sealed : Attribute

[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

[<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)>]
type ComVisibleAttribute = class
    inherit Attribute

Public NotInheritable Class ComVisibleAttribute
Inherits Attribute

Ereditarietà

Object

Attribute

ComVisibleAttribute

Attributi

AttributeUsageAttribute

Esempio

Nell'esempio seguente viene illustrato come controllare la visibilità su COM di una classe in modo che i membri siano invisibili. Impostando ComVisibleAttribute su falseMyClass(SampleClass nell'esempio di Visual Basic) e su e MyPropertyfalseMyMethod , è possibile evitare di esporre inavvertitamente i membri a COM tramite ereditarietà.

using namespace System::Runtime::InteropServices;

[ComVisible(false)]
ref class MyClass
{
private:
   int myProperty;

public:
   MyClass()
   {
      
      //Insert code here.
   }


   [ComVisible(false)]
   int MyMethod( String^ param )
   {
      return 0;
   }

   bool MyOtherMethod()
   {
      return true;
   }


   property int MyProperty 
   {

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

   }

};

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;
      }
   }
}

Imports System.Runtime.InteropServices

<ComVisible(False)> _
Class SampleClass
    
    Public Sub New()
        'Insert code here.
    End Sub
    
    <ComVisible(False)> _
    Public Function MyMethod(param As String) As Integer
        Return 0
    End Function    
    
    Public Function MyOtherMethod() As Boolean
        Return True
    End Function
    
    <ComVisible(False)> _
    Public ReadOnly Property MyProperty() As Integer
        Get
            Return MyProperty
        End Get
    End Property
    
End Class

Commenti

È possibile applicare questo attributo agli assembly, alle interfacce, alle classi, alle strutture, ai delegati, alle enumerazioni, ai campi, ai metodi, alle funzioni di accesso agli eventi o alle proprietà.

Il valore predefinito è true, che indica che il tipo gestito è visibile a COM. Questo attributo non è necessario per rendere visibili assembly e tipi gestiti pubblici; sono visibili per impostazione predefinita a COM. È possibile rendere visibili solo public i tipi. L'attributo non può essere usato per rendere visibile un tipo in caso contrario internal o protected per rendere visibili i membri di un tipo non visibile.

L'impostazione dell'attributo su false nell'assembly nasconde tutti i public tipi all'interno dell'assembly. È possibile creare tipi all'interno dell'assembly visibili impostando i singoli tipi su true. L'impostazione dell'attributo su false su su un tipo specifico nasconde tale tipo e i relativi membri. Tuttavia, non è possibile rendere visibili i membri di un tipo se il tipo è invisibile. L'impostazione dell'attributo su false su su un tipo impedisce l'esportazione di tale tipo in una libreria dei tipi; le classi non sono registrate; le interfacce non vengono mai reattive alle chiamate non gestite QueryInterface .

A meno che non si imposta in modo esplicito una classe e i relativi membri su false, le classi ereditate possono esporre ai membri della classe base COM invisibili nella classe originale. Ad esempio, se si imposta ClassA su false e non si applica l'attributo ai relativi membri, la classe e i relativi membri sono invisibili a COM. Tuttavia, se si deriva ClassB da ClassA ed esportare ClassB in COM, i membri classA diventano membri della classe base visibili di ClassB.

Per una descrizione dettagliata del processo di esportazione, vedere Assembly to Type Library Conversion Summary.

Costruttori

ComVisibleAttribute(Boolean)

Inizializza una nuova istanza della classe ComVisibleAttribute.

Proprietà

TypeId	Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)
Value	Ottiene un valore che indica se il tipo COM è visibile.

Metodi

Equals(Object)	Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute)
GetHashCode()	Restituisce il codice hash per l'istanza. (Ereditato da Attribute)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute)
Match(Object)	Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• Tlbexp.exe (utilità di esportazione della libreria dei tipi)