VCFileConfiguration.Tool プロパティ

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

ファイルをビルドするツールを取得または設定します。

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

構文

'宣言
Property Tool As Object
'使用
Dim instance As VCFileConfiguration
Dim value As Object

value = instance.Tool

instance.Tool = value

Object Tool { get; set; }

property Object^ Tool {
    Object^ get ();
    void set (Object^ value);
}

function get Tool () : Object
function set Tool (value : Object)

プロパティ値

型 : System.Object

ファイルをビルドするツール。

解説

特定のファイルと関連付けられたツールを変更するには、VCConfiguration オブジェクトのFileTools コレクションからツールオブジェクトを取得して、ツールのリセットに使用する必要があります。詳細については、このトピックの 2 つ目の例を参照してください。

例

統合開発環境 (IDE) で Tool プロパティを使用するサンプルコードを次に示します。

' add reference to Microsoft.VisualStudio.VCProjectEngine
Imports EnvDTE
Imports Microsoft.VisualStudio.VCProjectEngine

Public Module Module1
    Sub Test()
        Dim file, file2 As VCFile
        Dim col As IVCCollection
        Dim fileconfig As VCFileConfiguration
        Dim prj As VCProject
        prj = DTE.Solution.Projects.Item(1).Object
        col = prj.Files
        file = col.Item(1)
        col = file.FileConfigurations
        fileconfig = col.Item("Debug|Win32")
       MsgBox(fileconfig.Tool.ToolName)
    End Sub
End Module

指定したファイルに関連付けられたツールを変更する方法を次の例で示します。

' add reference to Microsoft.VisualStudio.VCProjectEngine
Imports EnvDTE
Imports Microsoft.VisualStudio.VCProjectEngine

Public Module Module1
    Sub Test()
        Dim file, file2 As VCFile
        Dim col As IVCCollection
        Dim col2 As IVCCollection
        Dim fileconfig As VCFileConfiguration
        Dim prj As VCProject
        Dim tool As Object

        ' retrieves the tool
        prj = DTE.Solution.Projects.Item(1).Object
        col2 = prj.Configurations
        Dim config As VCConfiguration
        config = col2.Item("Debug|Win32")
        tool = config.FileTools.Item(5)

        ' changes the tool associated with a file
        col = prj.Files
        file = col.Item(1)
        col = file.FileConfigurations
        fileconfig = col.Item("Debug|Win32")
        MsgBox(fileconfig.Tool.ToolName)
        fileconfig.Tool = tool
        MsgBox(fileconfig.Tool.ToolName)
    End Sub
End Module

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