InternalsVisibleToAttribute InternalsVisibleToAttribute InternalsVisibleToAttribute InternalsVisibleToAttribute Class

定義

通常は現在のアセンブリ内でのみ参照できる型が、指定したアセンブリから参照可能であることを指定します。Specifies that types that are ordinarily visible only within the current assembly are visible to a specified assembly.

public ref class InternalsVisibleToAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=true, Inherited=false)]
public sealed class InternalsVisibleToAttribute : Attribute
type InternalsVisibleToAttribute = class
    inherit Attribute
Public NotInheritable Class InternalsVisibleToAttribute
Inherits Attribute
継承
InternalsVisibleToAttributeInternalsVisibleToAttributeInternalsVisibleToAttributeInternalsVisibleToAttribute
属性

署名付きアセンブリSigned assemblies

次の例では、InternalsVisibleToAttribute属性をinternalという名前のメソッドAppendDirectorySeparatorで署名されたアセンブリの署名されたアセンブリを別に表示します。The following example uses the InternalsVisibleToAttribute attribute to make an internal method named AppendDirectorySeparator in a signed assembly visible to another signed assembly. 定義、FileUtilitiesを含む内部クラスAppendDirectorySeparatorメソッド。It defines a FileUtilities class that includes an internal AppendDirectorySeparator method. InternalsVisibleToAttribute属性を含むアセンブリに適用されます、FileUtilitiesクラス。The InternalsVisibleToAttribute attribute is applied to the assembly that contains the FileUtilities class. 属性は、という名前のアセンブリFriend1この内部メンバーにアクセスします。The attribute allows an assembly named Friend1 to access this internal member.

//
// The source code should be saved in a file named Example1.cs. It 
// can be compiled at the command line as follows:
//
//    csc /t:library /keyfile:<snkfilename> Assembly1.cs
//
// The public key of the Friend1 file should be changed to the full
// public key stored in your strong-named key file.
//
using System;
using System.IO;
using System.Runtime.CompilerServices;

[assembly: InternalsVisibleTo("Friend1, PublicKey=002400000480000094" + 
                              "0000000602000000240000525341310004000" +
                              "001000100bf8c25fcd44838d87e245ab35bf7" +
                              "3ba2615707feea295709559b3de903fb95a93" +
                              "3d2729967c3184a97d7b84c7547cd87e435b5" +
                              "6bdf8621bcb62b59c00c88bd83aa62c4fcdd4" +
                              "712da72eec2533dc00f8529c3a0bbb4103282" +
                              "f0d894d5f34e9f0103c473dce9f4b457a5dee" +
                              "fd8f920d8681ed6dfcb0a81e96bd9b176525a" +
                              "26e0b3")]

public class FileUtilities
{
   internal static string AppendDirectorySeparator(string dir)
   {
      if (! dir.Trim().EndsWith(Path.DirectorySeparatorChar.ToString()))
         return dir.Trim() + Path.DirectorySeparatorChar;
      else
         return dir;
   }
}
'
' The source code should be saved in a file named Example1.cs. It 
' can be compiled at the command line as follows:
'
'    vbc Assembly1.vb /t:library /keyfile:<snkfilename> 
'
' The public key of the Friend1 file should be changed to the full
' public key stored in your strong-named key file.
'
Imports System.IO
Imports System.Runtime.CompilerServices

<Assembly:InternalsVisibleTo("Friend1, PublicKey=002400000480000094" + _
                             "0000000602000000240000525341310004000" + _
                             "001000100bf8c25fcd44838d87e245ab35bf7" + _
                             "3ba2615707feea295709559b3de903fb95a93" + _
                             "3d2729967c3184a97d7b84c7547cd87e435b5" + _
                             "6bdf8621bcb62b59c00c88bd83aa62c4fcdd4" + _
                             "712da72eec2533dc00f8529c3a0bbb4103282" + _
                             "f0d894d5f34e9f0103c473dce9f4b457a5dee" + _
                             "fd8f920d8681ed6dfcb0a81e96bd9b176525a" + _
                             "26e0b3")>

Public Class FileUtilities
   Friend Shared Function AppendDirectorySeparator(dir As String) As String
      If Not dir.Trim().EndsWith(Path.DirectorySeparatorChar) Then
         Return dir.Trim() + Path.DirectorySeparatorChar
      Else
         Return dir
      End If   
   End Function
End Class

次の例をという名前の厳密な名前付きアセンブリにコンパイルされているかどうかFriend1Example.MainメソッドFriend1正常に呼び出すことができます、FileUtilities.AppendDirectorySeparatorメソッド、メソッドは内部ですが、Assembly1アセンブリ。If the following example is compiled into a strong-named assembly named Friend1, the Example.Main method in Friend1 can successfully call the FileUtilities.AppendDirectorySeparator method, although the method is internal to the Assembly1 assembly. 場合は、コマンドラインから c# でコンパイルする必要がありますを使用することに注意してください、 /outコンパイラ スイッチ、コンパイラが外部参照に連結すると、フレンド アセンブリの名前が使用できるようにします。Note that if you are compiling in C# from the command line, you must use the /out compiler switch to ensure that the name of the friend assembly is available when the compiler binds to external references.

//
// The assembly that exposes its internal types to this assembly should be
// named Assembly1.dll.
//
// The public key of this assembly should correspond to the public key
// specified in the class constructor of the InternalsVisibleTo attribute in the
// Assembly1 assembly.
//
#using <Assembly1.dll> as_friend

using namespace System;

void main()
{
   String^ dir = L"C:\\Program Files";
   dir = FileUtilities::AppendDirectorySeparator(dir);
   Console::WriteLine(dir);
}
// The example displays the following output:
//       C:\Program Files\
//
// The source code should be saved in a file named Friend1.cs. It 
// can be compiled at the command line as follows:
//
//    csc /r:Assembly1.dll /keyfile:<snkfilename> /out:Friend1.dll Friend1.cs
//
// The public key of the Friend1 assembly should correspond to the public key
// specified in the class constructor of the InternalsVisibleTo attribute in the
// Assembly1 assembly.
//
using System;

public class Example
{
   public static void Main()
   {
      string dir = @"C:\Program Files";
      dir = FileUtilities.AppendDirectorySeparator(dir);
      Console.WriteLine(dir);
   }
}
// The example displays the following output:
//       C:\Program Files\
'
' The source code should be saved in a file named Friend1.vb. It 
' can be compiled at the command line as follows:
'
'    vbc Friend1.vb /r:Assembly1.dll /keyfile:<snkfilename> 
'
' The public key of the Friend1 assembly should correspond to the public key
' specified in the class constructor of the InternalsVisibleTo attribute in the
' Assembly1 assembly.
'
Module Example
   Public Sub Main()
      Dim dir As String = "C:\Program Files"
      dir = FileUtilities.AppendDirectorySeparator(dir)
      Console.WriteLine(dir)
   End Sub
End Module
' The example displays the following output:
'       C:\Program Files\

署名のないアセンブリUnsigned assemblies

次の例では、InternalsVisibleToAttribute属性をinternalアセンブリ別に表示される符号なしのメンバーには、アセンブリが署名されていません。The following example uses the InternalsVisibleToAttribute attribute to make an internal member of an unsigned assembly visible to another unsigned assembly. 属性により、 internal StringLib.IsFirstLetterUpperCaseという名前のアセンブリ内のメソッドUtilityLibという名前のアセンブリ内のコードに表示されるFriend2します。The attribute ensures that the internal StringLib.IsFirstLetterUpperCase method in an assembly named UtilityLib is visible to the code in an assembly named Friend2. UtilityLib.dll のソース コードを次に示します。The following is the source code for UtilityLib.dll:

using System;
using System.Runtime.CompilerServices;

[assembly: InternalsVisibleToAttribute("Friend2")]

namespace Utilities.StringUtilities
{
   public class StringLib
   {
      internal static bool IsFirstLetterUpperCase(String s)
      {
         string first = s.Substring(0, 1);
         return first == first.ToUpper();
      }
   }
}

Imports System.Runtime.CompilerServices

<assembly: InternalsVisibleTo("Friend2")>

Namespace Utilities.StringUtilities
   Public Class StringLib
      Friend Shared Function IsFirstLetterUpperCase(s As String) As Boolean
         Dim first As String = s.Substring(0, 1)
         Return first = first.ToUpper()
      End Function
   End Class
End Namespace

次の例のソース コードを提供する、Friend2アセンブリ。The following example provides the source code for the Friend2 assembly. 場合は、コマンドラインから c# でコンパイルする必要がありますを使用することに注意してください、 /outコンパイラ スイッチ、コンパイラが外部参照に連結すると、フレンド アセンブリの名前が使用できるようにします。Note that if you are compiling in C# from the command line, you must use the /out compiler switch to ensure that the name of the friend assembly is available when the compiler binds to external references.

#using <UtilityLib.dll> as_friend

using namespace System;
using namespace Utilities::StringUtilities;

void main()
{
   String^ s = "The Sign of the Four";
   Console::WriteLine(StringLib::IsFirstLetterUpperCase(s));
}
using System;
using Utilities.StringUtilities;

public class Example
{
   public static void Main()
   {
      String s = "The Sign of the Four";
      Console.WriteLine(StringLib.IsFirstLetterUpperCase(s));
   }
}
Imports Utilities.StringUtilities

Module Example
   Public Sub Main()
      Dim s As String = "The Sign of the Four"
      Console.WriteLine(StringLib.IsFirstLetterUpperCase(s))
   End Sub
End Module

注釈

通常、型とメンバーをinternalスコープ (c#) とFriend(Visual Basic) でスコープが定義されているアセンブリでのみ表示されます。Ordinarily, types and members with internal scope (in C#) and Friend scope (in Visual Basic) are visible only in the assembly in which they are defined. InternalsVisibleToAttribute属性は、それらの種類にも表示されているフレンド アセンブリと呼ばれますが、指定したアセンブリ内。The InternalsVisibleToAttribute attribute makes them also visible to the types in a specified assembly, which is known as a friend assembly. これだけに当てはまりinternal(Friend VB で) のメソッドのみ、notprivateものです。This only applies to internal (Friend in VB) methods only, not private ones.

属性は、アセンブリ レベルで適用されます。The attribute is applied at the assembly level. つまり、ソース コード ファイルの先頭には追加できますまたは Visual Studio プロジェクトの AssemblyInfo ファイルに記述できます。This means that it can be included at the beginning of a source code file, or it can be included in the AssemblyInfo file in a Visual Studio project. 属性を使用して、内部の型と、現在のアセンブリのメンバーにアクセスできる 1 つのフレンド アセンブリを指定することができます。You can use the attribute to specify a single friend assembly that can access the internal types and members of the current assembly. 2 つの方法では、複数のフレンド アセンブリを定義できます。You can define multiple friend assemblies in two ways. それらには、次の例に示すように個々 のアセンブリ レベル属性として表示できます。They can appear as individual assembly-level attributes, as the following example illustrates.

[assembly:InternalsVisibleTo("Friend1a")]
[assembly:InternalsVisibleTo("Friend1b")]
<assembly:InternalsVisibleTo("Friend1a")>
<assembly:InternalsVisibleTo("Friend1b")>

個別に表示されることができますもInternalsVisibleToAttributeタグが 1 つassemblyキーワードでは、次の例として示します。They can also appear with separate InternalsVisibleToAttribute tags but a single assembly keyword, as the following example illustrates.

[assembly:InternalsVisibleTo("Friend2a"), 
          InternalsVisibleTo("Friend2b")]
<Assembly:InternalsVisibleTo("Friend2a"), _
 Assembly:InternalsVisibleTo("Friend2b")>

フレンド アセンブリがで識別される、InternalsVisibleToAttributeコンス トラクター。The friend assembly is identified by the InternalsVisibleToAttribute constructor. 現在のアセンブリとフレンド アセンブリの両方が、署名する必要がある、または両方のアセンブリは厳密な名前で署名する必要があります。Both the current assembly and the friend assembly must be unsigned, or both assemblies must be signed with a strong name.

両方のアセンブリに署名がない場合、assemblyName引数が指定のディレクトリ パスまたはファイル名の拡張子を除いた、フレンド アセンブリの名前で構成されます。If both assemblies are unsigned, the assemblyName argument consists of the name of the friend assembly, specified without a directory path or file name extension.

強力な両方のアセンブリが署名されている場合の名前、引数、InternalsVisibleToAttributeコンス トラクターは、ディレクトリ パスまたはファイル名拡張子を除いた、完全な公開キー (およびない公開キー トークン) と共にアセンブリの名前ので構成する必要があります。If both assemblies are signed with a strong name, the argument to the InternalsVisibleToAttribute constructor must consist of the name of the assembly without its directory path or file name extension, along with the full public key (and not its public key token). 厳密な名前のアセンブリの完全な公開キーを取得するを参照してください、完全な公開キーを取得するこの記事で後述する「します。To get the full public key of a strong-named assembly, see the Getting the full public key section later in this article. 使用しての詳細についてはInternalsVisibleToAttributeアセンブリの厳密な名前を使用した、次を参照してください。、InternalsVisibleToAttributeコンス トラクター。For more information about using InternalsVisibleToAttribute with strong-named assemblies, see the InternalsVisibleToAttribute constructor.

値を含めないでください、 CultureInfoVersion、またはProcessorArchitecture フィールドに、引数は、Visual Basic、c#、および C++ コンパイラ、コンパイラ エラーとして処理します。Do not include values for the CultureInfo, Version, or ProcessorArchitecture field in the argument; the Visual Basic, C#, and C++ compilers treat this as a compiler error. コンパイラ エラーとして処理しませんを使用するかどうか (など、 IL アセンブラー (ILAsm.exe))、アセンブリが厳密な名前と、MethodAccessException例外がスローされる指定したフレンド アセンブリが初めて、アセンブリを含む、InternalsVisibleToAttribute属性。If you use a compiler that does not treat it as an error (such as the IL Assembler (ILAsm.exe)) and the assemblies are strong-named, a MethodAccessException exception is thrown the first time the specified friend assembly accesses the assembly that contains the InternalsVisibleToAttribute attribute.

この属性を使用する方法の詳細については、次のトピックを参照してください。For more information about how to use this attribute, see the following topics:

完全な公開キーの取得Getting the full public key

使用することができます、厳密名ツール (Sn.exe)厳密な名前キー (.snk) ファイルから完全な公開キーを取得します。You can use the Strong Name Tool (Sn.exe) to retrieve the full public key from a strong-named key (.snk) file. これを行うには、次の手順を実行します。To do this, you perform the following steps:

  1. 別のファイルに、厳密な名前キー ファイルから公開キーを抽出します。Extract the public key from the strong-named key file to a separate file:

    *Sn-p***snk_file outfile Sn -p snk_file outfile

  2. 完全な公開キーをコンソールに表示します。Display the full public key to the console:

    *Sn tp***outfileSn -tp outfile

  3. コピーして、ソース コードに完全な公開キーの値を貼り付けます。Copy and paste the full public key value into your source code.

C# を使用したフレンド アセンブリをコンパイルします。Compiling the friend assembly with C#

使用して、出力ファイル (.exe または .dll) の名前を明示的に指定する必要があります、フレンド アセンブリをコンパイルすると、C# コンパイラを使用する場合、 /outコンパイラ オプション。If you use the C# compiler to compile the friend assembly, you must explicitly specify the name of the output file (.exe or .dll) by using the /out compiler option. この指定は必ず行ってください。コンパイラが外部参照にバインドする時点ではまだ、ビルド中のアセンブリの名前が生成されていないためです。This is required because the compiler has not yet generated the name for the assembly it is building at the time it is binding to external references. /Outコンパイラ オプションは、Visual Basic コンパイラと、対応する省略可能な -アウトまたは -oフレンドをコンパイルするときに、コンパイラ オプションを使用しない必要がありますアセンブリをF#コンパイラ。The /out compiler option is optional for the Visual Basic compiler, and the corresponding -out or -o compiler option should not be used when compiling friend assemblies with the F# compiler.

C++ のフレンド アセンブリをコンパイルします。Compiling the friend assembly with C++

C++ では、内部のメンバーで有効にするために、InternalsVisibleToAttributeフレンド アセンブリにアクセスできる属性は、使用する必要があります、 as_friend C++ ディレクティブの属性。In C++, in order to make the internal members enabled by the InternalsVisibleToAttribute attribute accessible to a friend assembly, you must use the as_friend attribute in the C++ directive. 詳細については、次を参照してください。フレンド アセンブリ (C++)します。For more information, see Friend Assemblies (C++).

コンストラクター

InternalsVisibleToAttribute(String) InternalsVisibleToAttribute(String) InternalsVisibleToAttribute(String) InternalsVisibleToAttribute(String)

指定したフレンド アセンブリの名前を使用して InternalsVisibleToAttribute クラスの新しいインスタンスを初期化します。Initializes a new instance of the InternalsVisibleToAttribute class with the name of the specified friend assembly.

プロパティ

AllInternalsVisible AllInternalsVisible AllInternalsVisible AllInternalsVisible

このプロパティは実装されていません。This property is not implemented.

AssemblyName AssemblyName AssemblyName AssemblyName

internal キーワードを使用してマークされている型と型のメンバーをすべて参照できるようにする、フレンド アセンブリの名前を取得します。Gets the name of the friend assembly to which all types and type members that are marked with the internal keyword are to be made visible.

TypeId TypeId TypeId TypeId

派生クラスで実装されると、この Attribute の一意の識別子を取得します。When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

このインスタンスが、指定されたオブジェクトと等価であるかどうかを示す値を返します。Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

このインスタンスのハッシュ コードを返します。Returns the hash code for this instance.

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

派生クラスでオーバーライドされるとき、このインスタンスの値が派生クラスの既定値であるかどうかを示します。When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

明示的なインターフェイスの実装

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

一連の名前を対応する一連のディスパッチ識別子に割り当てます。Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

オブジェクトの型情報を取得します。この情報はインターフェイスの型情報の取得に使用できます。Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

オブジェクトが提供する型情報インターフェイスの数 (0 または 1) を取得します。Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

オブジェクトによって公開されたプロパティおよびメソッドへのアクセスを提供します。Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

適用対象