ComVisibleAttribute Класс

Определение

Пространство имен:

System.Runtime.InteropServices

Сборки:

netstandard.dll, System.Runtime.dll

Исходный код:

ComVisibleAttribute.cs

Управляет специальными возможностями отдельного управляемого типа или члена или всех типов в сборке в 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

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

Object

Attribute

ComVisibleAttribute

Атрибуты

AttributeUsageAttribute

Примеры

В следующем примере показано, как управлять видимостью com класса, чтобы его члены были невидимыми. Задав ComVisibleAttribute значение false в 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 типы можно сделать видимыми. Атрибут нельзя использовать для того, чтобы сделать иначе internal или тип видимым для COM или protected сделать элементы невидимого типа видимым.

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

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

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

Имя	Описание
ComVisibleAttribute(Boolean)	Инициализирует новый экземпляр класса ComVisibleAttribute.

Свойства

Имя	Описание
TypeId	При реализации в производном классе получает уникальный идентификатор для этого Attribute. (Унаследовано от Attribute)
Value	Возвращает значение, указывающее, является ли тип COM видимым.

Методы

Имя	Описание
Equals(Object)	Возвращает значение, указывающее, равен ли этот экземпляр указанному объекту. (Унаследовано от Attribute)
GetHashCode()	Возвращает хэш-код для этого экземпляра. (Унаследовано от Attribute)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
IsDefaultAttribute()	При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute)
Match(Object)	При переопределении в производном классе возвращает значение, указывающее, равен ли этот экземпляр указанному объекту. (Унаследовано от Attribute)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

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

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