ComVisibleAttribute クラス

[アーティクル]
03/28/2008

個々のマネージ型またはマネージメンバ、またはアセンブリ内のすべての型の COM 参照可能範囲を制御します。

この型のすべてのメンバの一覧については、ComVisibleAttribute メンバを参照してください。

System.Object
System.Attribute
System.Runtime.InteropServices.ComVisibleAttribute

<AttributeUsage(AttributeTargets.Assembly Or AttributeTargets.Class _
   Or AttributeTargets.Struct Or AttributeTargets.Enum Or _
   AttributeTargets.Method Or AttributeTargets.Property Or _
   AttributeTargets.Field Or AttributeTargets.Interface Or _
   AttributeTargets.Delegate)>
NotInheritable Public Class ComVisibleAttribute   Inherits Attribute
[C#]
[AttributeUsage(AttributeTargets.Assembly | AttributeTargets.Class
   | AttributeTargets.Struct | AttributeTargets.Enum |
   AttributeTargets.Method | AttributeTargets.Property |
   AttributeTargets.Field | AttributeTargets.Interface |
   AttributeTargets.Delegate)]
public sealed class ComVisibleAttribute : Attribute
[C++]
[AttributeUsage(AttributeTargets::Assembly |
   AttributeTargets::Class | AttributeTargets::Struct |
   AttributeTargets::Enum | AttributeTargets::Method |
   AttributeTargets::Property | AttributeTargets::Field |
   AttributeTargets::Interface | AttributeTargets::Delegate)]
public __gc __sealed class ComVisibleAttribute : public Attribute
[JScript]
public
   AttributeUsage(AttributeTargets.Assembly | AttributeTargets.Class |
   AttributeTargets.Struct | AttributeTargets.Enum |
   AttributeTargets.Method | AttributeTargets.Property |
   AttributeTargets.Field | AttributeTargets.Interface |
   AttributeTargets.Delegate)
class ComVisibleAttribute extends Attribute

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

この属性は、アセンブリ、インターフェイス、クラス、構造体、デリゲート、列挙体、フィールド、メソッド、またはプロパティに適用できます。

既定値は true です。これは、マネージ型が COM から参照できることを示します。この属性は、パブリックマネージアセンブリとパブリックマネージ型を参照可能にする場合には必要ありません。これらは、既定で COM から参照できます。参照可能にできるのは public 型だけです。この属性を使用して、 internal 型または protected 型を COM から参照可能にしたり、参照不可能な型のメンバを参照可能にしたりすることはできません。

アセンブリに対してこの属性を false に設定すると、そのアセンブリ内のすべての public 型を参照できなくなります。アセンブリ内の型を個別に参照可能にするには、個々の型に対して true を設定します。特定の型に対してこの属性を false に設定すると、その型とメンバを参照できなくなります。ただし、参照不可能な型のメンバを参照可能にすることはできません。この属性が false に設定された型は、タイプライブラリにエクスポートできません。また、クラスの場合は登録できなくなります。インターフェイスの場合は、アンマネージの QueryInterface の呼び出しに対して応答しなくなります。

クラスおよびそのメンバが明示的に false に設定されていない限り、継承したクラスでは、元のクラスで参照不可能だった基本クラスのメンバを COM に公開できます。たとえば、ClassA を false に設定し、そのメンバにはこの属性を適用しなかった場合、ClassA とそのメンバを COM が参照することはできません。しかし、ClassA から継承して ClassB を作成し、ClassB を COM にエクスポートすると、ClassA のメンバは、ClassB の基本クラスのメンバとして参照可能になります。

エクスポートプロセスの詳細については、「アセンブリからタイプライブラリへの変換の要約」を参照してください。

使用例

COM に対するクラスの参照可能範囲を制御して、そのメンバを参照不可能にする方法を次の例に示します。 MyClass では ComVisibleAttribute を false に設定し、 MyMethod と MyProperty では false を設定することにより、継承を通じて意図せずメンバが COM に公開されることを防ぐことができます。

 
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

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

[C++] 
using namespace System::Runtime::InteropServices;

[ComVisible(false)]
__gc class MyClass
{
private:
   int myProperty;
public:
   MyClass()
   {
      //Insert code here.
   }
   
   [ComVisible(false)]
   int MyMethod(String* param) 
   {
      return 0;
   }

   bool MyOtherMethod() 
   {
      return true;
   }

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

[JScript] 
import System.Runtime.InteropServices;

ComVisible(false) class MyClass
{
   public function MyClass()
   {
      //Insert code here.
   }
   
   ComVisible(false) public function MyMethod(param : String) : int 
   {
      return 0;
   }

   public function MyOtherMethod() : boolean
   {
      return true;
   }

   ComVisible(false) public function get MyProperty() : int 
   {
       return MyProperty;
   }
}

必要条件

名前空間: System.Runtime.InteropServices

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

アセンブリ: Mscorlib (Mscorlib.dll 内)

参照

ComVisibleAttribute メンバ | System.Runtime.InteropServices 名前空間 | タイプライブラリエクスポータ (Tlbexp.exe) | アセンブリからタイプライブラリへの変換の要約

次の方法で共有

ComVisibleAttribute クラス

スレッドセーフ

解説

使用例

必要条件

参照

その他のリソース