CS801～2000

C# コンパイルエラー CS1725について解説: InternalsVisibleTo属性の正しい利用方法

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

CS1725は、C#で発生するコンパイルエラーです。

InternalsVisibleTo属性を用いる際、フレンドアセンブリ参照にバージョンやカルチャ、公開キートークンなど余分な情報を含めるとエラーが発生します。

開発環境構築済みの場合でも、正しくはアセンブリ名のみを指定してください。

目次から探す

CS1725エラーの発生状況
- エラーメッセージの詳細解析
- 誤ったInternalsVisibleTo属性の記述例
InternalsVisibleTo属性の正しい使用方法
- 基本仕様と記述ルール
- 正しいコード例と注意点
エラー修正手順とコード例
- 修正手順の流れ
- 開発環境での検証方法
開発時の注意事項
- 関連エラーとの識別方法
- 再発防止のためのチェックポイント
まとめ

CS1725エラーの発生状況

エラーメッセージの詳細解析

CS1725エラーは、InternalsVisibleTo属性において、アセンブリ名以外のパラメータ(例えばバージョン、カルチャ、公開キートークン、プロセッサアーキテクチャ)が指定されている場合に発生します。

エラーメッセージには「フレンドアセンブリ参照 ‘reference’ は使用できません。」とあり、指定してはいけない情報が含まれていることを示しています。

また、フレンドアセンブリとして指定されるべきは、単にアセンブリ名のみであり、余計なパラメータが加えられると正しく動作しません。

これにより、アクセス権の不整合など、意図しない挙動を招く可能性があります。

誤ったInternalsVisibleTo属性の記述例

以下のサンプルコードは、誤ったパラメータを含むためにCS1725エラーが発生する例です。

このコードは実行前にコンパイルエラーとなり、実際に実行することはできません。

// サンプルコード：誤ったInternalsVisibleTo属性の指定
using System;
using System.Runtime.CompilerServices;
// versionパラメータを含めているためエラーとなる
[assembly:InternalsVisibleTo("FriendAssembly,version=1.0.0.0")]
partial class TestClass
{
    public static string strBar = "エラー原因の文字列";
}
class Program
{
    static void Main()
    {
        // ここでTestClassの内部メンバーにアクセスしようとしますが、
        // コンパイルエラーのため実行されません。
        Console.WriteLine(TestClass.strBar);
    }
}

(出力はありません。上記コードはコンパイルエラー CS1725 により実行できません。)

InternalsVisibleTo属性の正しい使用方法

基本仕様と記述ルール

InternalsVisibleTo属性は、指定したフレンドアセンブリから対象アセンブリ内のinternalメンバーにアクセスできるようにするための機能です。

この属性を使用する際は、アセンブリ名のみを指定し、バージョンやカルチャなどの追加パラメータは含めない必要があります。

正しい記述にすることで、後々のアクセス権の問題を防ぐことができます。

アセンブリ名の正しい指定方法

アセンブリ名は文字列として指定します。

許容される記述は、単にアセンブリ名だけです。

例えば、"FriendAssembly"のように指定してください。

誤った例は、"FriendAssembly,version=1.0.0.0"のように余計な情報を含めてしまうケースです。

パラメータの省略について

追加パラメータ(バージョン、カルチャ、公開キートークン、プロセッサアーキテクチャなど)は、すべて省略する必要があります。

これにより、シンプルで予測可能な動作が保証され、フレンドアセンブリからのアクセスが適切に機能します。

正しいコード例と注意点

以下のサンプルコードは、正しい指定例を示しています。

ポイントは、アセンブリ名のみを指定している点です。

すべてのサンプルコードは実行可能な形でMain関数を含んでおります。

// サンプルコード：正しいInternalsVisibleTo属性の指定例
using System;
using System.Runtime.CompilerServices;
// アセンブリ名のみ指定することで正しく機能します
[assembly:InternalsVisibleTo("FriendAssembly")]
internal partial class TestClass
{
    public static string strBar = "Hello, Internals!";
}
class Program
{
    static void Main()
    {
        // FriendAssemblyからのアクセスを前提とした内部メンバーへの参照
        Console.WriteLine(TestClass.strBar);  // 正常に出力されます
    }
}

Hello, Internals!

エラー修正手順とコード例

修正手順の流れ

CS1725エラーの修正手順は以下のような流れになります。

まず、InternalsVisibleTo属性に指定されているパラメータを確認します。
バージョン、カルチャ、公開キートークン、プロセッサアーキテクチャなどが含まれている場合、それらを削除します。
修正後、再度コンパイルを行い、エラーが解消されているかを確認します。

修正前後のコード比較

以下に、修正前と修正後のサンプルコードを示します。

<em>修正前のコード例(エラー発生)</em>

// 修正前のコード：誤ったInternalsVisibleTo属性の指定
using System;
using System.Runtime.CompilerServices;
// 誤った指定によりCS1725エラーが発生します
[assembly:InternalsVisibleTo("FriendAssembly,version=1.0.0.0")]
partial class TestClass
{
    public static string strBar = "エラー発生中";
}
class Program
{
    static void Main()
    {
        Console.WriteLine(TestClass.strBar);
    }
}

(コンパイルエラー CS1725 により実行できません)

<em>修正後のコード例(正常動作)</em>

// 修正後のコード：正しいInternalsVisibleTo属性の指定
using System;
using System.Runtime.CompilerServices;
// アセンブリ名のみを指定することでエラーが解消されます
[assembly:InternalsVisibleTo("FriendAssembly")]
partial class TestClass
{
    public static string strBar = "エラー解消済み";
}
class Program
{
    static void Main()
    {
        Console.WriteLine(TestClass.strBar);  // 正常に出力されます
    }
}

エラー解消済み

開発環境での検証方法

修正後は、以下の手順に沿って動作を検証してください。

Visual StudioなどのIDEでプロジェクトをビルドし、コンパイルエラーが解消されたことを確認します。
コマンドラインからcscコマンドを利用し、ビルドが成功するか確認します。
実際に実行し、TestClass.strBarの内容が正しく出力されるかどうかを検証してください。

開発時の注意事項

再発防止のためのチェックポイント

InternalsVisibleTo属性の記述時は、アセンブリ名以外のパラメータが含まれていないかを必ず確認する
コードレビュー時に、属性の指定内容をチェックリストに追加する
ビルド時に発生するエラーメッセージをその都度確認し、同様の記述ミスがないかを厳しく監視する
CI/CDパイプラインで静的解析ツールを用いることで、早期にエラーを検出する対策を講じる

これらの注意点を守ることで、CS1725エラーの再発防止に役立てていただければ幸いです。

まとめ

この記事では、CS1725エラーの発生原因とエラーメッセージの詳細、誤ったInternalsVisibleTo属性の記述例について解説しています。

また、正しいアセンブリ名指定方法とパラメータ省略の基本要件、正しいコード例と修正手順、開発環境での検証方法、そして類似エラーとの識別や再発防止のチェックポイントが示されています。

これにより、正しく属性指定を行い、エラーを未然に防ぐ手法が理解できます。