References.Add メソッド
プロジェクトに新しい参照を追加します。
名前空間: VSLangProj
アセンブリ: VSLangProj (vslangproj.dll 内)
構文
'宣言
'使用
パラメータ
bstrPath
必ず指定します。COM 参照または .NET Framework 参照のパス。パラメータは次の 3 つの形式のいずれかで指定します。
単純な .NET Framework オブジェクト名 ("System" など)。
.NET Framework ファイル名 (.tlb ファイル、.dll ファイル、または .ocx ファイル)。
COM ライブラリ ファイル (.tlb ファイル、.dll ファイル、.ocx ファイル、または .exe ファイル)。COM オブジェクトの場合は、ファイル名を完全パスで指定します ("D:\SomeApplication\SomeApp.dll" など)。後述の「COM 参照」セクションに記載されている、COM の .exe ファイルの参照を追加する場合の制限事項を参照してください。
戻り値
Reference オブジェクトを返します。
解説
bstrPath パラメータが示すファイルにタイプ ライブラリがない場合、または参照を解決できない場合 (「参照の解決」セクションを参照) は、エラーが発生します。
このメソッドでは、新しい参照の Identity、Culture、MajorVersion、MinorVersion、BuildNumber、および RevisionNumber がプロジェクトに既に存在している参照と重複している場合でも、エラーは発生しません。この場合、bstrPath パラメータで指定した参照は、既にプロジェクトに追加されています。プロジェクトに既に存在している、同一の参照の ProjectItem が代わりに返されます。
参照の Identity が同じでも、MajorVersion、MinorVersion、BuildNumber、RevisionNumber、または Culture のいずれかが異なる参照がプロジェクトで見つかると、このメソッドはエラーになります。
参照を削除するには、Remove を使用します。
使用例
' Macro Editor
Imports VSLangProj
Sub AddExample()
' This example assumes that the first project in the solution is
' either a Visual Basic or C# project.
Dim aVSProject As VSProject = _
CType(DTE.Solution.Projects.Item(1).Object, VSProject)
Dim refs As References = aVSProject.References
' Adds a reference to a compiled .NET project.
refs.Add("C:\path\program.dll")
' Adds a reference to an installed ActiveX control.
refs.Add("C:\WINNT\system32\msmask32.ocx")
' Adds a reference to System.dll as an example of adding a
' reference using just the simple name.
refs.Add("System")
End Sub