フレンドアセンブリ (C# および Visual Basic)

[アーティクル]
08/09/2011

フレンドアセンブリは、別のアセンブリの Friend 型 (Visual Basic) または internal 型 (C#) とメンバーにアクセスできるアセンブリです。アセンブリをフレンドアセンブリとして指定すると、他のアセンブリがアクセスできるように型とメンバーをパブリックとしてマークする必要がなくなります。これは、次のようなシナリオの場合、特に便利です。

単体テスト時に、テストコードが別のアセンブリで実行されているときに、Friend (Visual Basic) または internal (C#) とマークされているテスト対象のアセンブリ内のメンバーにアクセスする必要がある。
クラスライブラリの開発時に、そのライブラリへの追加内容が別のアセンブリに含まれているが、Friend (Visual Basic) または internal (C#) とマークされている既存のアセンブリ内のメンバーへのアクセスが必要である。

解説

InternalsVisibleToAttribute 属性を使用して、特定のアセンブリに対する 1 つ以上のフレンドアセンブリを識別できます。アセンブリ A の InternalsVisibleToAttribute 属性を使用して、アセンブリ AssemblyB をフレンドアセンブリとして指定する例を次に示します。これにより、アセンブリ AssemblyB は、Friend (Visual Basic) または internal (C#) とマークされているアセンブリ A 内のすべての型とメンバーにアクセスできます。

注意

アセンブリ (アセンブリ A) の内部型または内部メンバーにアクセスするアセンブリ (アセンブリ AssemblyB) をコンパイルするときは、/out コンパイラオプションを使用して、出力ファイル (.exe または .dll) の名前を明示的に指定する必要があります。この操作が必要なのは、コンパイラが外部参照にバインドした時点では構築するアセンブリの名前がまだ生成されていないからです。詳細については、「/out (C#)」および「/out (Visual Basic)」を参照してください。

Imports System.Runtime.CompilerServices
Imports System
<Assembly: InternalsVisibleTo("AssemblyB")> 

' Friend class.
Friend Class FriendClass
    Public Sub Test()
        Console.WriteLine("Sample Class")
    End Sub
End Class

' Public class with a Friend method.
Public Class ClassWithFriendMethod
    Friend Sub Test()
        Console.WriteLine("Sample Method")
    End Sub
End Class

using System.Runtime.CompilerServices;
using System;

[assembly: InternalsVisibleTo("AssemblyB")]

// The class is internal by default.
class FriendClass
{
    public void Test()
    {
        Console.WriteLine("Sample Class");
    }
}

// Public class that has an internal method.
public class ClassWithFriendMethod
{
    internal void Test()
    {
        Console.WriteLine("Sample Method");
    }

}

フレンドとして明示的に指定されているアセンブリだけが、Friend (Visual Basic) 型または internal (C#) 型とメンバーにアクセスできます。たとえば、アセンブリ B がアセンブリ A のフレンドアセンブリであり、アセンブリ C がアセンブリ B を参照した場合、C は A の Friend 型 (Visual Basic) または internal 型 (C#) にはアクセスできません。

コンパイラは、InternalsVisibleToAttribute 属性に渡されるフレンドアセンブリの名前に対して基本的な検証を行います。アセンブリ A がアセンブリ B をフレンドアセンブリとして宣言する場合、検証規則は次のようになります。

アセンブリ A に厳密な名前が付けられている場合、アセンブリ B にも厳密な名前が付けられている必要があります。属性に渡されるフレンドアセンブリ名は、アセンブリ名と、アセンブリ B に署名するために使用される厳密名キーの公開キーで構成する必要があります。

InternalsVisibleToAttribute 属性に渡されるフレンドアセンブリ名は、アセンブリ B の厳密な名前にすることはできません。アセンブリバージョン、カルチャ、アーキテクチャ、または公開キートークンを含めないでください。
アセンブリ A に厳密な名前が付けられていない場合、フレンドアセンブリ名はアセンブリ名だけで構成します。詳細については、「方法: 署名のないフレンドアセンブリを作成する (C# および Visual Basic)」を参照してください。
アセンブリ B に厳密な名前が付けられている場合、プロジェクト設定によって、またはコマンドラインで /keyfile コンパイラオプションを使用して、アセンブリ B の厳密名キーを指定する必要があります。詳細については、「方法: 署名されたフレンドアセンブリを作成する (C# および Visual Basic)」を参照してください。

StrongNameIdentityPermission クラスを使用した場合も型を共有できますが、次の点が異なります。

StrongNameIdentityPermission は、個々の型に適用され、フレンドアセンブリはアセンブリ全体に適用されます。
アセンブリ B と共有する必要がある型がアセンブリ A に数多く存在する場合は、それらすべてに StrongNameIdentityPermission を追加する必要があります。フレンドアセンブリを使用すると、フレンド関係を 1 回宣言するだけで済みます。
StrongNameIdentityPermission を使用する場合は、共有が必要な型を public と宣言する必要があります。フレンドアセンブリを使用する場合は、共有する型を Friend (Visual Basic) または internal (C#) と宣言します。

モジュールファイル (拡張子が .netmodule のファイル) からアセンブリの Friend 型 (Visual Basic) または internal 型 (C#) とメソッドにアクセスする方法の詳細については、「/moduleassemblyname (Visual Basic)」および「/moduleassemblyname (C#)」を参照してください。

参照

フレンド アセンブリ (C# および Visual Basic)

解説

参照

処理手順

参照

概念

その他の技術情報

その他のリソース

フレンドアセンブリ (C# および Visual Basic)