VCProject.CanAddAssemblyReference メソッド

[アーティクル]
01/29/2008

指定したアセンブリ (.NET) 参照を追加できるかどうかを返します。

名前空間 : Microsoft.VisualStudio.VCProjectEngine
アセンブリ : Microsoft.VisualStudio.VCProjectEngine (Microsoft.VisualStudio.VCProjectEngine.dll 内)

構文

'宣言
Function CanAddAssemblyReference ( _
    bstrRef As String _
) As Boolean
'使用
Dim instance As VCProject
Dim bstrRef As String
Dim returnValue As Boolean

returnValue = instance.CanAddAssemblyReference(bstrRef)

bool CanAddAssemblyReference(
    string bstrRef
)

bool CanAddAssemblyReference(
    [InAttribute] String^ bstrRef
)

function CanAddAssemblyReference(
    bstrRef : String
) : boolean

パラメータ

bstrRef
型 : System.String

アセンブリ参照。

戻り値

型 : System.Boolean

指定のアセンブリ (.NET) 参照を追加できる場合は true、それ以外の場合は false です。

解説

たとえば、GUID が無効な場合は、アセンブリ参照を追加できません。

通常、このメソッドは、AddAssemblyReference メソッドと共に使用します。このメソッドを使用してアセンブリ参照を追加できるかどうかを調べ、追加できる場合は、AddAssemblyReference を呼び出します。

例

このサンプルコードをコンパイルして実行する方法については、「方法 : Visual C++ コードモデル機能拡張のプログラム例をコンパイルする」を参照してください。

CanAddAssemblyReference は、アセンブリのパスに基づいて、プロジェクトに .NET アセンブリ参照を追加します (可能な場合)。

' Add a reference to Microsoft.VisualStudio.VCProjectEngine and have a 
' Visual C++ project loaded before running this example.
Imports EnvDTE
Imports Microsoft.VisualStudio.VCProjectEngine
Public Module Module1
    Sub Test()
        Dim prj As VCProject
        Dim vcar As VCAssemblyReference
        Dim refcfg As VCReferenceConfiguration

        prj = DTE.Solution.Projects.Item(1).Object
        If prj.CanAddAssemblyReference("C:\Program Files\ _
        Microsoft Visual Studio 8\Common7\IDE\ _
        PublicAssemblies\envdte.dll") Then
           vcar = prj.AddAssemblyReference("C:\Program Files\ _
           Microsoft Visual Studio 8\Common7\IDE\ _
           PublicAssemblies\envdte.dll")
        End If
        refcfg = vcar.ReferenceConfigurations.Item(1)
        MsgBox("Consumable? " & refcfg.ConsumableByDesigner)
    End Sub
End Module