ComCompatibleVersionAttribute 類別

定義

命名空間:

System.Runtime.InteropServices

組件:

System.Runtime.InteropServices.dll

來源:

ComCompatibleVersionAttribute.cs

指出對於 COM 用戶端，所有目前組件版本中的類別都和組件之前版本中的類別相容。

public ref class ComCompatibleVersionAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)]
public sealed class ComCompatibleVersionAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)>]
type ComCompatibleVersionAttribute = class
    inherit Attribute

Public NotInheritable Class ComCompatibleVersionAttribute
Inherits Attribute

繼承

Object

Attribute

ComCompatibleVersionAttribute

屬性

AttributeUsageAttribute

範例

下列範例示範如何在具有較高版本號碼的元件中指定元件版本 1.0.0.0.0。 不論新的元件版本為何，元件中的所有 CLID 都是使用 1.0.0.0.0 版產生，而不是使用目前的元件版本。

using namespace System;
using namespace System::Reflection;
using namespace System::Runtime::InteropServices;

[assembly: AssemblyVersion("3.0.0.0")];
[assembly: ComCompatibleVersion(1,0,0,0)];
namespace MyNamespace
{
    public ref class TheClass
    {
        // Insert code.
    };
};

using System;
using System.Reflection;
using System.Runtime.InteropServices;

[assembly: AssemblyVersion("3.0.0.0")]
[assembly: ComCompatibleVersion(1,0,0,0)]
namespace MyNamespace
{
    public class TheClass
    {
        // Insert code.
    }
}

Imports System.Reflection
Imports System.Runtime.InteropServices

<assembly: AssemblyVersion("3.0.0.0")>
<assembly: ComCompatibleVersion(1,0,0,0)>
Namespace MyNamespace
    Public Class TheClass
        ' Insert code.
    End Class
End Namespace

備註

您可以將此屬性套用至元件。

根據預設， Tlbexp.exe (類型庫導出工具) 會使用元件的版本號碼來計算 (CLSID) 的類別標識碼。 每次匯出新的元件版本時，所有公用 COM 可見類別都會收到新的 CLSID。

您可以套用 ComCompatibleVersionAttribute 屬性，強制元件目前版本中類別的所有 CLSID 與舊版元件中的類別 CLSID 相同。 只要 CLSID 維持不變，舊版 COM 應用程式就可以在卸載原始元件之後，使用較新版本的相容元件。 如果您將 套用 System.Runtime.InteropServices.GuidAttribute 至類別以明確設定其CLSID，則 ComCompatibleVersionAttribute 不會有任何作用。

這個屬性的屬性會合併成元件版本的四個部分。 請一律指定與目前元件回溯相容的最低版本，以便使用該版本來計算元件中的所有 CLID。

建構函式

ComCompatibleVersionAttribute(Int32, Int32, Int32, Int32)

使用組件的主要版本、次要版本、組建和修訂編號，初始化 ComCompatibleVersionAttribute 類別的新執行個體。

屬性

BuildNumber	取得組件的組建編號。
MajorVersion	取得組件的主要版本編號。
MinorVersion	取得組件的次要版本編號。
RevisionNumber	取得組件的修訂編號。
TypeId	在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)

方法

Equals(Object)	傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute)
GetHashCode()	傳回這個執行個體的雜湊碼。 (繼承來源 Attribute)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsDefaultAttribute()	在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute)
Match(Object)	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承來源 Attribute)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• GuidAttribute
• Tlbexp.exe (類型程式庫匯出工具)