BuildManager インターフェイス
カスタム ツールの実行によって生成されたポータブル実行可能 (PE: Portable Executable) ファイルを管理するために、サードパーティの開発者が使用します。
名前空間: VSLangProj
アセンブリ: VSLangProj (VSLangProj.dll 内)
構文
'宣言
<GuidAttribute("C711E2B7-3C58-4C37-9359-705208A890AE")> _
Public Interface BuildManager
[GuidAttribute("C711E2B7-3C58-4C37-9359-705208A890AE")]
public interface BuildManager
[GuidAttribute(L"C711E2B7-3C58-4C37-9359-705208A890AE")]
public interface class BuildManager
[<GuidAttribute("C711E2B7-3C58-4C37-9359-705208A890AE")>]
type BuildManager = interface end
public interface BuildManager
BuildManager 型で公開されるメンバーは以下のとおりです。
プロパティ
名前 | 説明 | |
---|---|---|
ContainingProject | 選択した項目を含むプロジェクトを取得します。読み取り専用。 | |
DesignTimeOutputMonikers | プロジェクトの一時的なポータブル実行可能 (PE) ファイルのモニカーを取得します。 | |
DTE | トップレベルの機能拡張オブジェクトを取得します。 | |
Parent | 指定したオブジェクトの直接の親オブジェクトを取得します。 |
このページのトップへ
メソッド
名前 | 説明 | |
---|---|---|
BuildDesignTimeOutput | 一時的にポータブル実行可能 (PE) ファイル (PE: Portable Executable) を作成し、その記述を XML 文字列で返します。 |
このページのトップへ
解説
BuildManager を使用すると、カスタム ツール出力から作成されたプロジェクトの一時的なポータブル実行可能 (PE: Portable Executable) ファイルにアクセスできます。 詳細については、「BuildManager オブジェクトの概要」および RunCustomTool メソッドに関するトピックを参照してください。
例
この例では、プロジェクト内の一時的な PE に対するすべてのモニカーの一覧が表示されます。 モニカーが関連付けられているのは、デザイン時の出力を生成するカスタム ツールが CustomTool プロパティに設定されているプロジェクト項目だけです。 モニカーを表示するための簡単な方法の 1 つは、Windows アプリケーション プロジェクトを作成し、XML スキーマ プロジェクト項目を追加することです。 XML スキーマ プロジェクト項目の CustomTool プロパティは、MSDataSetGenerator に設定されています。
' Macro editor
Sub BuildManagerExample()
Try
Dim proj As VSLangProj.VSProject = _
CType(DTE.Solution.Projects.Item(1).Object, VSLangProj.VSProject)
Dim build As BuildManager = proj.BuildManager
Dim monikers As String() = _
CType(build.DesignTimeOutputMonikers, String())
Dim moniker As String
' List the monikers.
For Each moniker In monikers
MsgBox(moniker & ControlChars.CrLf & _
build.BuildDesignTimeOutput(moniker))
Next
' Hook up some events.
Dim buildEvents As BuildManagerEvents = _
proj.Events.BuildManagerEvents
AddHandler buildEvents.DesignTimeOutputDeleted, _
AddressOf OutputDeleted
AddHandler buildEvents.DesignTimeOutputDirty, _
AddressOf OutputDirty
Catch ex As System.Exception
MsgBox("Cannot list monikers and hook up events.")
End Try
End Sub
Sub OutputDeleted(ByVal deletedMoniker As String)
MsgBox(deletedMoniker & " was deleted.")
End Sub
Sub OutputDirty(ByVal dirtyMoniker As String)
MsgBox(dirtyMoniker & " is dirty.")
End Sub