ComVisibleAttribute Класс

Определение

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)]
[System.Runtime.InteropServices.ComVisible(true)]
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

[<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)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ComVisibleAttribute = class
    inherit Attribute

Public NotInheritable Class ComVisibleAttribute
Inherits Attribute

Наследование

Object

Attribute

ComVisibleAttribute

Атрибуты

AttributeUsageAttribute ComVisibleAttribute

Примеры

В следующем примере показано, как управлять видимостью класса COM, чтобы его члены были невидимыми. Задав значение ComVisibleAttributefalse on MyClass(SampleClass в примере Visual Basic), а false также в MyMethod и MyProperty, можно избежать случайного предоставления членам COM через наследование.

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

Комментарии

Этот атрибут можно применять к сборкам, интерфейсам, классам, структурам, делегатам, перечислениям, полям, методам, методам доступа к событиям или свойствам.

По умолчанию используется значение true, указывающее, что управляемый тип является видимым для COM. Этот атрибут не требуется, чтобы сделать общедоступные управляемые сборки и типы видимыми; По умолчанию они видны com. Видимыми могут быть только public типы. Атрибут не может использоваться для того, чтобы сделать другим тип или internalprotected видимым для COM или сделать элементы невидимого типа видимыми.

Если задать для атрибута значение false в сборке, все public типы в ней скрываются. Вы можете выборочно сделать типы в сборке видимыми, задав для отдельных типов значение true. Если задать для атрибута значение для false определенного типа, этот тип и его члены скрываются. Однако элементы типа нельзя сделать видимыми, если тип невидим. Установка атрибуту значения false для типа предотвращает экспорт этого типа в библиотеку типов; классы не регистрируются; интерфейсы никогда не реагируют на неуправляемые QueryInterface вызовы.

Если явно не задать классу и его членам falseзначение , наследуемые классы могут предоставляться членам базового класса COM, которые невидимы в исходном классе. Например, если задать для ClassA значение false и не применять атрибут к его членам, класс и его члены будут невидимы для COM. Однако если вы наследуете КлассB от ClassA и экспортируете КлассB в COM, элементы ClassA станут видимыми элементами базового класса КлассаB.

Подробное описание процесса экспорта см. в разделе Сводка по преобразованию библиотеки сборок в тип.

Конструкторы

Свойства

Методы

Явные реализации интерфейса

Применяется к

См. также раздел

• Tlbexp.exe (программа экспорта библиотек типов)