CS401～800

C# コンパイラエラー CS0669：ComImport属性クラスのコンストラクター問題の原因と対策を解説

2025-03-29更新日: 2025-03-29

CS0669 は、[ComImport] 属性が付与されたクラスにユーザー定義のコンストラクターが存在する際に発生するエラーです。

COM相互運用では、共通言語ランタイム側でコンストラクターが提供されるため、クラス内に独自のコンストラクターを定義する必要はありません。

エラー解消には不要なコンストラクターの削除が推奨されます。

目次から探す

CS0669エラーの原因
- ComImport属性の役割
- ユーザー定義コンストラクターの制限
CS0669エラーの対策
- 不要なコンストラクターの削除方法
- 正しいCOM相互運用の設定
コード例と詳細な検証
- 発生例のソースコード解析
- 修正例のソースコード比較
まとめ

CS0669エラーの原因

ComImport属性の役割

COM相互運用の仕組み

COM技術は、Windows環境で異なるプログラミング言語同士が相互に利用できる仕組みを提供しています。

C#では、COMオブジェクトと連携する際に、ComImport属性を用いてCOMコンポーネントをマネージドコードとして扱うための準備を行います。

この属性を指定することにより、実行時に共通言語ランタイム(CLR)がCOM相互運用層を介して、COMコンポーネントの生成と管理を自動的に担当する仕組みが有効になります。

数式の形式で表すと、COM相互運用は $M a n a g e d O b j e c t \leftrightarrow C O M O b j e c t$ のように双方向の連携が実現されます。

COMオブジェクトとマネージドオブジェクトの関係

COMオブジェクトはネイティブコードで動作するため、初期化やメモリ管理の方法がマネージドコードとは異なります。

ComImport属性が付与されたクラスは、ユーザーがコンストラクターを定義する必要がなく、CLRが内部的に必要な処理を実施するため、正しい初期化が保証されています。

これにより、COMオブジェクトとマネージドオブジェクトは、各々の管理方式に合わせた最適なリソース管理が行われ、相互運用が円滑に進むようになっています。

ユーザー定義コンストラクターの制限

エラー発生の理由

ComImport属性をもつクラスにおいて、ユーザー定義のコンストラクターを定義すると、CLRがCOMオブジェクトの生成に利用する内部の仕組みと衝突してしまいます。

コンパイラーは、この衝突を検出すると、エラーCS0669を発生させることで、ユーザーが不適切なコンストラクターを定義していることを警告します。

内部生成されるコンストラクターとの整合性を保つため、ユーザー定義のコンストラクターは許可されないためです。

発生例の詳細な解析

具体的な例として、以下のコードはエラーCS0669を引き起こす典型的なサンプルです。

using System.Runtime.InteropServices;
// COMオブジェクトとして認識させるための属性を付与
[ComImport, Guid("00000000-0000-0000-0000-000000000001")]
class TestClass
{
    // ユーザー定義のコンストラクターはエラー対象
    TestClass()
    {
    }
    public static void Main()
    {
    }
}

上記のコードでは、TestClassにユーザー定義のコンストラクターが存在しているため、コンパイラーは内部生成されるべきコンストラクターと衝突すると判断し、CS0669エラーを発生させます。

エラーメッセージは「ComImport属性を持つクラスはユーザー定義のコンストラクターを持てません」という内容になるため、修正が必要となります。

CS0669エラーの対策

不要なコンストラクターの削除方法

コード修正の手順

エラーCS0669が発生した場合、最も簡単な対策はユーザー定義のコンストラクターを削除することです。

COMオブジェクトとして利用するクラスは、CLRが内部で生成するコンストラクターに任せるため、明示的なコンストラクター定義をなくす必要があります。

以下に、修正手順の概要を示します。

該当するクラスからユーザー定義のコンストラクター部分を削除する。
クラスに必要なフィールドやプロパティの初期化があれば、適切な初期化方法を検討する。
再度コンパイルして、CS0669エラーが解消されるか確認する。

修正後のコード例の解説

修正後のコードは、例えば次のようにシンプルに記述できます。

using System.Runtime.InteropServices;
// COM相互運用を行うための属性を付与
[ComImport, Guid("00000000-0000-0000-0000-000000000001")]
class TestClass
{
    // ユーザー定義のコンストラクターは削除し、内部生成に委ねる
    public static void Main()
    {
        // COMオブジェクトの生成はCLRが内部で処理するため、ここではインスタンス化は不要
    }
}

この修正により、COM相互運用層が正しく動作し、コンパイラーは内部コンストラクターを利用するため、CS0669エラーは解消されます。

正しいCOM相互運用の設定

修正例のコード比較

修正前後のコードを比較すると、ユーザー定義のコンストラクターが存在するか否かで違いが生じます。

修正前のコードでは、ユーザー定義のコンストラクターがコンパイラーによりエラーとして検出されますが、修正後ではその部分が削除され、CLRによりCOMオブジェクトが正常に生成されます。

以下の表に違いを示します。

項目 | 修正前 | 修正後

— | — | —

コンストラクター定義 | ユーザー定義のコンストラクターあり | ユーザー定義のコンストラクター削除

エラー発生 | CS0669が発生 | エラーなし

COM相互運用 | 内部コンストラクターとの衝突あり | CLRが管理する内部コンストラクターを利用

設定変更時の注意点

COMオブジェクトの使用に際しては、以下の点に注意してください。

・ComImport属性を付与するクラスは、ユーザー定義のコンストラクターを絶対に持たないようにする。

・GUIDの指定は正確に行う必要があり、COM側で定義されているGUIDと一致するよう管理する。

・必要な初期化処理がある場合は、静的コンストラクターやクラスの外部での初期化処理を活用する。

これらの対策により、COM相互運用の動作が正しく行われ、エラーが防止されます。

コード例と詳細な検証

発生例のソースコード解析

エラー箇所の特定方法

実際にコンパイルを行うと、コンパイラーはエラーCS0669を発生させた箇所として、ユーザー定義のコンストラクター行を指摘します。

Visual Studioや他のIDEでは、エラーメッセージが直接当該行に表示されるため、どの部分が問題であるかを容易に特定できます。

また、エラーメッセージには「ComImport属性を持つクラスはユーザー定義のコンストラクターを持てません」と記載され、原因が明確に示されるため確認がしやすくなっています。

コンパイラーのエラーメッセージの解説

エラーメッセージ「CS0669」は、COM相互運用用に予約された内部コンストラクターとの衝突が原因であることを意味しています。

これは、ユーザー定義コンストラクターが存在することで、CLRが内部的に管理する初期化処理が実行できなくなるために発生する問題です。

エラーメッセージは、原因と対策のヒントを提供しており、該当するコンストラクターを削除することで解消できると明示されています。

修正例のソースコード比較

修正前後の問題点と改善点

修正前のコードは以下のようになっています。

using System.Runtime.InteropServices;
[ComImport, Guid("00000000-0000-0000-0000-000000000001")]
class TestClass
{
    // ユーザー定義のコンストラクターが存在するためエラーが出る
    TestClass()
    {
        // 初期化処理(しかし、ここでの初期化は不要)
    }
    public static void Main()
    {
    }
}

上記のコードでは、ユーザー定義のコンストラクターがCS0669エラーを引き起こす原因となっています。

これに対して、修正後のコードは次のようになります。

using System.Runtime.InteropServices;
[ComImport, Guid("00000000-0000-0000-0000-000000000001")]
class TestClass
{
    // ユーザー定義のコンストラクターを削除し、CLRの内部初期化に任せる
    public static void Main()
    {
        // COMオブジェクトの生成はCLRが自動的に処理するため、明示的なインスタンス化は省略
    }
}

改善点としては、ユーザー定義のコンストラクターが削除されたため、CLRの内部で行われる適切なコンストラクションプロセスが利用され、エラーが発生しなくなります。

動作確認のポイント

修正後のコードをコンパイルする際は、以下のポイントを確認してください。

・コンパイルエラーが解消され、CS0669エラーが発生しないこと。

・COMコンポーネントとの連携が正常に動作するか、実行時に確認する。

・GUIDの設定が正しいか、指定された値がCOM側と一致しているかを再確認する。

実行例を含む簡単なサンプルとして、以下にMain関数を備えたコードを示します。

using System;
using System.Runtime.InteropServices;
[ComImport, Guid("00000000-0000-0000-0000-000000000001")]
class ComExample
{
    // ユーザー定義のコンストラクターは削除済み
    public static void Main()
    {
        Console.WriteLine("COM相互運用用のクラスが正しく設定されています。");
        // 動作確認のため、簡単な出力を行う
    }
}

COM相互運用用のクラスが正しく設定されています。

上記サンプルコードは、コンパイル後に実行すると指定の文字列が出力され、プログラムが正しく動作していることを確認できます。

これにより、修正が正しく反映されたことが実践的に検証できます。

まとめ

この記事では、C#でCOM相互運用を行う際に使用するComImport属性の役割と、ユーザー定義コンストラクターが存在すると発生するエラーCS0669の原因を解説しています。

エラーの詳細な解析から、不要なコンストラクターを削除する具体的な修正手順・コード例、正しい設定方法までを明確に示しているため、読者はCOMオブジェクトとマネージドオブジェクトの連携の仕組みと、適切な対策方法を理解できます。