ComCompatibleVersionAttribute クラス

.NET Framework クラス ライブラリ リファレンス

ComCompatibleVersionAttribute クラス

現在のバージョンのアセンブリ内のクラスはすべて、以前のバージョンのアセンブリ内のクラスと互換性があることを COM クライアントに対して示します。

名前空間: System.Runtime.InteropServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<AttributeUsageAttribute(AttributeTargets.Assembly, Inherited:=False)> _
<ComVisibleAttribute(True)> _
Public NotInheritable Class
 ComCompatibleVersionAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As ComCompatibleVersionAttribute

C#

[AttributeUsageAttribute(AttributeTargets.Assembly, Inherited=false)]
 
[ComVisibleAttribute(true)] 
public sealed class ComCompatibleVersionAttribute
 : Attribute

C++

[AttributeUsageAttribute(AttributeTargets::Assembly, Inherited=false)]
 
[ComVisibleAttribute(true)] 
public ref class ComCompatibleVersionAttribute
 sealed : public Attribute

J#

/** @attribute AttributeUsageAttribute(AttributeTargets.Assembly, Inherited=false)
 */ 
/** @attribute ComVisibleAttribute(true) */ 
public final class ComCompatibleVersionAttribute
 extends Attribute

JScript

AttributeUsageAttribute(AttributeTargets.Assembly, Inherited=false)
 
ComVisibleAttribute(true) 
public final class ComCompatibleVersionAttribute
 extends Attribute

解説

この属性は、アセンブリに適用できます。

既定で タイプ ライブラリ エクスポータ (Tlbexp.exe) は、アセンブリのバージョン番号を使用してクラス ID (CLSID) を算出します。パブリックで COM 参照可能な各クラスには、新しいアセンブリのバージョンをエクスポートするごとに新しい CLSID が与えられます。

ComCompatibleVersionAttribute 属性を適用すると、現在のバージョンのアセンブリ内のクラスの CLSID がすべて、以前のバージョンのアセンブリ内のクラスの CLSID と同じになります。CLSID が同じである限り、以前のアセンブリをアンインストールした後でも、COM のレガシ アプリケーションは互換性があるアセンブリの最新バージョンをそのまま使用できます。CLSID を明示的に設定するため System.Runtime.InteropServices.GuidAttribute をクラスに適用した場合、ComCompatibleVersionAttribute は無視されます。

アセンブリのバージョンの 4 つの部分は、この属性のプロパティの組み合わせで表されます。必ず、現在のアセンブリと下位互換性がある一番低いバージョンを指定してください。このバージョン情報がアセンブリ内のすべての CLSID の計算に使用されます。

使用例

アセンブリのバージョンとして 1.0.0.0 を指定する方法を次の例に示します。この例では、アセンブリのバージョンにこれより大きい番号が定義されています。アセンブリの新しいバージョン番号にかかわらず、アセンブリ内の CLSID はすべてバージョン 1.0.0.0 を使用して生成されます。アセンブリの現在のバージョンは無視されます。

Visual Basic

Imports System
 Imports System.Runtime.Interop
 Assembly: AssemblyVersion ("3.0.0.0")
 Assembly: ComCompatibleVersionAttribute(1,0,0,0)
 Module MyNamespace
   Public Class MyClass
     ' Insert code.
   End Class

C#

using System;
 using System.Runtime.InteropServices;
 [assembly: AssemblyVersion ("3.0.0.0")
 [assembly: ComCompatibleVersion(1,0,0,0)]
 namespace MyNamespace
 {
   class MyClass
   {
     // Insert code.
   }
 }

継承階層

System.Object
   System.Attribute
    System.Runtime.InteropServices.ComCompatibleVersionAttribute

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
ComCompatibleVersionAttribute メンバ
System.Runtime.InteropServices 名前空間
GuidAttribute
その他の技術情報
タイプ ライブラリ エクスポータ (Tlbexp.exe)