レベル1

C# コンパイラ警告 CS1762 の原因と対策について解説

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

CS1762は、C#のコンパイラ警告で、埋め込まれた相互運用型情報の設定が一致しない場合に表示されます。

たとえば、参照している一方のアセンブリでEmbed Interop TypesがTrueに設定されているのに対し、他方がFalseの場合などに発生します。

同じ設定に統一することで警告を解消できます。

目次から探す

CS1762 警告の理解
- 警告発生の条件
- エラーコードの意味
警告の原因詳細
- アセンブリ設定の不一致
- 埋め込み型情報の仕組み
対策方法
トラブルシューティング事例
- 具体的な問題事例
- エラーメッセージ調査の手法
まとめ

CS1762 警告の理解

警告発生の条件

Embed Interop Types プロパティの役割

Embed Interop Typesプロパティは、参照先のアセンブリから相互運用機能の型情報を直接現在のアセンブリに埋め込むかどうかを制御する設定です。

このプロパティを True に設定すると、コンパイラは該当アセンブリ内の COM型情報をビルド時に埋め込み、実行時には直接そのアセンブリへの依存性が不要となります。

逆に、False にした場合は型情報の埋め込みが行われず、プライマリ相互運用アセンブリ(PIA)が提供する型情報に依存する形になります。

参照アセンブリ間の設定不一致

複数のアセンブリが互いに参照し合う場合、各アセンブリで Embed Interop Types の設定が異なると、コンパイラ警告 CS1762 が発生する可能性があります。

たとえば、Assembly1 が True に設定されているのに対し、Assembly2 が False の場合、コンパイラは一方の設定に基づいた型情報を正しく埋め込むことができず、矛盾が生じた旨を警告します。

エラーコードの意味

コンパイラの動作と影響

警告 CS1762 は、相互運用機能アセンブリ間での型情報の埋め込み設定が一致していない場合に発生します。

その結果、ビルド時に不要な型情報の重複や不足が生じる可能性があり、最終的な実行ファイルの動作に予期しない影響が出る場合もあります。

コンパイラは自動的に /link オプションと同等の処理を行おうとしますが、設定の不整合が解消されない状態では、警告を出力してユーザーに設定の見直しを促します。

/link オプションとの関連

/link オプションは、コンパイラに対し指定したアセンブリから型情報を埋め込む動作を指示するものです。

Visual Studio で Embed Interop Typesプロパティを True に設定するのは、この /link オプションを使用するのと同様の動作となります。

そのため、コマンドラインでのコンパイル時にも同じ仕組みが働く点に留意する必要があります。

警告の原因詳細

アセンブリ設定の不一致

Assembly1 の設定と影響

Assembly1 では Embed Interop Typesプロパティが True に設定され、相互運用機能の型情報が埋め込まれます。

この設定により、Assembly1 を参照している他のアセンブリは、PIA に依存せずに必要な型情報を得ることができます。

ただし、参照元のアセンブリとの設定が統一されていない場合、予期しない型情報の重複や競合が発生する可能性があります。

Assembly2 の設定との違い

一方、Assembly2 では Embed Interop Typesプロパティが False に設定されている場合、型情報は PIA から取得されるため、Assembly1 との設定に不一致が生じます。

この不一致が、コンパイラ警告 CS1762 の発生原因となります。

つまり、両者で型情報の取得方法が異なるため、埋め込み型情報の整合性が保たれなくなるのです。

埋め込み型情報の仕組み

Primary Interop Assembly (PIA) の役割

プライマリ相互運用アセンブリ (PIA) は、COM コンポーネントが提供する型情報をまとめたアセンブリです。

Embed Interop Types を False に設定した場合、実行時に PIA から適切な型情報が提供されるため、型の埋め込みは不要となります。

PIA を使用することでファイルサイズの小さなアセンブリが生成される利点がありますが、設定の不一致があると動作に影響が及ぶ可能性があります。

コンパイラによる型情報埋め込みの処理

コンパイラは、Embed Interop Types が True の場合、対象アセンブリから必要な型情報を抽出し、現在のアセンブリに直接埋め込みます。

この処理は、コマンドラインの /link オプションと同様の動作となり、型情報を実行ファイルに含めるため、参照先のアセンブリが不要になるというメリットがあります。

しかし、複数のアセンブリ間で設定が統一されていないと、どの型情報を使用するべきか曖昧になり、警告が発生する仕組みです。

対策方法

設定統一による解決策

Visual Studio での設定変更手順

Visual Studio では、ソリューションエクスプローラー上で参照設定を確認することができます。

各アセンブリの参照について、プロパティウィンドウを開き、Embed Interop Typesプロパティを確認・変更してください。

すべての参照先で同じ設定(たとえば True もしくは False)に統一することで、警告を回避できます。

プロジェクトファイルの直接編集方法

場合によっては、.csproj ファイルを直接編集することで一括設定が可能です。

以下のように該当する参照設定部分を統一してください。

<ItemGroup>
  <Reference Include="Unofficial.Interop">
    <EmbedInteropTypes>true</EmbedInteropTypes>
  </Reference>
</ItemGroup>

上記の設定例は、すべての参照に対して true を指定する形です。

複数プロジェクトで同じ設定を適用する場合、スクリプトで自動的に書き換える方法も検討するとよいでしょう。

コマンドラインオプションの活用

/link オプションの使用例

コマンドラインからコンパイルする場合、/link オプションを使用してアセンブリを参照することもできます。

以下は簡単なサンプルコードとそのコンパイル例です。

using System;
public class Program
{
    // COMコンポーネントの操作サンプル(コメントは日本語で説明)
    public static void Main(string[] args)
    {
        Console.WriteLine("Hello, Interop Types!");
        // 仮想的なCOM操作の例
        string message = "サンプルのメッセージ";
        Console.WriteLine(message);
    }
}

Hello, Interop Types!
サンプルのメッセージ

上記のサンプルでは、コンパイラに対し /link:Unofficial.Interop.dll のようなオプションを組み合わせることで、型情報の埋め込みを行う設定と同等の処理が行われます。

適切なオプションの設定により、各参照アセンブリの型情報取得方法を統一できる点に注意してください。

設定変更時の注意点

パフォーマンスへの影響確認

設定を変更すると、アセンブリのサイズや実行時のロード速度に影響が出る可能性があります。

埋め込み型情報が多い場合、アセンブリのサイズが大きくなることがあるため、変更後はパフォーマンスの測定を実施してください。

サイズやロード時間の変化を確認することで、変更による影響範囲を把握できます。

互換性の検証手順

設定変更後は、関連プロジェクト全体で互換性が保たれているかを検証する必要があります。

テストプロジェクトを実行し、依存している COM コンポーネントとの連携が正常に行われていることを確認してください。

特に、複数の参照先を持つ大規模プロジェクトでは、各モジュール間の連携部分を重点的にチェックすることが望ましいです。

トラブルシューティング事例

具体的な問題事例

設定変更後の確認プロセス

設定を統一した後は、まずプロジェクト全体のリビルドを行い、警告メッセージが解消されているか確認してください。

加えて、アプリケーションの各機能が正常に動作しているか、単体テストや統合テストを通して確認する手法が有効です。

不整合な設定が解消されると、警告メッセージは出力されなくなります。

発生しやすい障害と対処法

設定不一致が解消されなかった場合、以下のような障害が発生することがあります。

ビルド時に複数の型情報が混在し、正しい型を特定できなくなる
実行時に予期しない例外が発生する

これらの問題に対しては、各プロジェクトの参照設定を再度確認し、漏れがないかチェックすることが重要です。

また、必要に応じてキャッシュのクリアも検討してください。

エラーメッセージ調査の手法

デバッグ時の確認ポイント

エラーメッセージが表示された際には、以下のポイントを確認することが推奨されます。

各プロジェクトの .csproj ファイルに記載された EmbedInteropTypes の値
Visual Studio のプロパティウィンドウで参照設定が統一されているかどうか
コンパイラの出力ログにおける /link オプションの適用状況

これにより、どの設定が不整合を引き起こしているか特定しやすくなります。

エラー文中に示されるアセンブリ名や警告コードをもとに、原因箇所を絞り込むと解決への手助けとなります。

まとめ

本記事では、CS1762 警告の仕組みと発生条件について解説しています。

Embed Interop Typesプロパティが果たす役割や、参照アセンブリ間の設定不一致が原因で警告が出る理由を説明し、Assembly1 と Assembly2 の設定の違いや PIA の役割、コンパイラによる型情報埋め込みの処理についても触れています。

また、Visual Studio やプロジェクトファイルの編集、コマンドラインの /link オプションを用いた設定統一方法と、変更後のパフォーマンスや互換性確認、トラブルシューティング事例も紹介しています。