ProjectCollection ProjectCollection ProjectCollection ProjectCollection Class

定義

一連の関連プロジェクト、それらのツールセット、既定のグローバル プロパティのセット、およびビルドに使用するロガーをカプセル化します。Encapsulates a set of related projects, their toolsets, a default set of global properties, and the loggers that should be used to build them. このクラスのグローバル バージョンは、既定のプロジェクト コレクションとして機能します。A global version of this class acts as the default project collection.

public ref class ProjectCollection : IDisposable
public class ProjectCollection : IDisposable
type ProjectCollection = class
    interface IDisposable
Public Class ProjectCollection
Implements IDisposable
継承
ProjectCollectionProjectCollectionProjectCollectionProjectCollection
実装

注釈

複数のプロジェクト コレクションは、アプリケーション ドメイン内に存在できます。Multiple project collections can exist within an app domain. ただし、これらする必要があります同時にビルドできません。However, these must not build concurrently.

コンストラクター

ProjectCollection() ProjectCollection() ProjectCollection() ProjectCollection()

グローバル プロパティやロガーを持たないプロジェクト コレクションを作成します。Creates a project collection with no global properties or loggers. プロジェクト コレクションのツールセットは、構成ファイルとレジストリから初期化されます。The project collection toolset is initialized from the configuration file and registry.

ProjectCollection(IDictionary<String,String>) ProjectCollection(IDictionary<String,String>) ProjectCollection(IDictionary<String,String>) ProjectCollection(IDictionary<String,String>)

指定したグローバル プロパティを使用して、ロガーを持たないプロジェクト コレクションをインスタンス化します。ツールセットの情報は、構成ファイルとレジストリから読み取ります。Instantiates a project collection with specified global properties, no loggers, and that reads toolset information from the configuration file and registry.

ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>, ToolsetDefinitionLocations, Int32, Boolean) ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>, ToolsetDefinitionLocations, Int32, Boolean) ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>, ToolsetDefinitionLocations, Int32, Boolean) ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>, ToolsetDefinitionLocations, Int32, Boolean)

指定したグローバル プロパティ、ロガー、ノード数、および onlyLogCriticalEvents 値を使用して、プロジェクト コレクションを作成します。Creates a project collection with specified global properties, loggers, node count, and onlyLogCriticalEvents value. プロジェクト コレクションのツールセットは、指定した場所にあるツールセットから初期化されます。The project collection toolset is initialized from toolsets in the given locations.

ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, ToolsetDefinitionLocations) ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, ToolsetDefinitionLocations) ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, ToolsetDefinitionLocations) ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, ToolsetDefinitionLocations)

指定したグローバル プロパティ、ロガー、およびツールセットの場所を使用して、プロジェクト コレクションをインスタンス化します。Instantiates a project collection with specified global properties and loggers and using the specified toolset locations.

ProjectCollection(ToolsetDefinitionLocations) ProjectCollection(ToolsetDefinitionLocations) ProjectCollection(ToolsetDefinitionLocations) ProjectCollection(ToolsetDefinitionLocations)

グローバル プロパティやロガーを持たないプロジェクト コレクションを作成します。Creates a project collection with no global properties or loggers. プロジェクト コレクションのツールセットは、指定した場所にあるツールセットから初期化されます。The project collection toolset is initialized from toolsets in the given locations.

プロパティ

Count Count Count Count

このコレクションに現在読み込まれているプロジェクトの数を取得します。Gets the number of projects currently loaded into this collection.

DefaultToolsVersion DefaultToolsVersion DefaultToolsVersion DefaultToolsVersion

このプロジェクト コレクションの既定のツール バージョンを取得します。Gets the default tools version of this project collection.

DisableMarkDirty DisableMarkDirty DisableMarkDirty DisableMarkDirty

このコレクション内のプロジェクトで、MarkDirty() を一時的に無効にするかどうかを決定するフラグを取得または設定します。Gets or sets a flag that determines whether MarkDirty() is temporarily disabled on projects in this collection. これにより、たとえば、グローバル プロパティを設定してもプロジェクトが要再評価としてマークされないようにすることができます。This allows, for example, a global properties to be set without projects getting marked dirty for reevaluation as a consequence.

GlobalProjectCollection GlobalProjectCollection GlobalProjectCollection GlobalProjectCollection

グローバル プロジェクト コレクション オブジェクトを取得します。Gets the global project collection object.

GlobalProperties GlobalProperties GlobalProperties GlobalProperties

このコレクション内のすべてのプロジェクトに対する読み取り専用の既定のグローバル プロパティを取得します。Gets the read-only default global properties for all projects in this collection.

HostServices HostServices HostServices HostServices

このプロジェクト コレクションに含まれているプロジェクトのビルド時に、タスクにホスト サービスを提供するオブジェクトを取得または設定します。Gets or sets an object that provides host services to tasks during builds of projects contained in the project collection.

IsBuildEnabled IsBuildEnabled IsBuildEnabled IsBuildEnabled

このプロジェクト コレクション内のプロジェクトのターゲットとタスクがビルド可能かどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the targets and tasks of projects in the project collection can be built.

LoadedProjects LoadedProjects LoadedProjects LoadedProjects

このコレクションに現在読み込まれているすべてのプロジェクトを取得します。Gets all the projects currently loaded into this collection.

Loggers Loggers Loggers Loggers

このコレクション内のプロジェクトのビルドに使用できる、すべてのロガーを取得します。Gets all loggers that projects in this collection can use for their builds.

OnlyLogCriticalEvents OnlyLogCriticalEvents OnlyLogCriticalEvents OnlyLogCriticalEvents

警告やエラーなどの重大なイベントだけを記録するかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether only critical events such as warnings and errors are logged.

SkipEvaluation SkipEvaluation SkipEvaluation SkipEvaluation

このコレクション内のプロジェクトで、ReevaluateIfNecessary を一時的に無効にするかどうかを示す値を取得または設定します。Gets or sets a value the indicates whether ReevaluateIfNecessary is temporarily disabled on projects in this collection. これは、ホストでプロジェクトに対して多数の読み書きを行う必要があり、一時的に正確さよりもパフォーマンスを優先する場合に役立ちます。This is useful when the host expects to make a number of reads and writes to projects, and wants to temporarily sacrifice correctness for performance.

ToolsetLocations ToolsetLocations ToolsetLocations ToolsetLocations

ツールセットを検索する場所を取得します。Gets the locations used to find the toolsets.

Toolsets Toolsets Toolsets Toolsets

このプロジェクト コレクションで使用できるツールセットを取得します。Gets the toolsets available to this project collection.

Version Version Version Version

MSBuild エンジンを含むアセンブリ ファイルのファイル バージョンを取得します。Gets the file version of the assembly file that contains the MSBuild engine.

メソッド

AddToolset(Toolset) AddToolset(Toolset) AddToolset(Toolset) AddToolset(Toolset)

新しいツールセットをプロジェクト コレクションに追加します。Adds a new toolset to the project collection. 同じツール バージョンの既存のツールセットは置き換えられます。Replaces any existing toolset with the same tools version.

ContainsToolset(String) ContainsToolset(String) ContainsToolset(String) ContainsToolset(String)

指定したツール バージョンのツールセットが定義されているかどうかを確認します。Determines whether a toolset is defined for the given tools version.

Dispose() Dispose() Dispose() Dispose()

マネージド リソースとアンマネージド リソースの両方を解放します。Releases both managed and unmanaged resources. ホストでプロジェクト コレクションが不要になったときに呼び出されます。Called when a host no longer needs the project collection.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

マネージド リソースとアンマネージド リソースの両方を解放します。Releases both managed and unmanaged resources. ホストでプロジェクト コレクションが不要になったときに呼び出されます。Called when a host no longer needs the project collection. プロジェクト コレクションが所有しているログ サービスをすべてシャットダウンし、ロガー スレッドを解放します。Shuts down any logging services that the project collection owns and releases the logger thread.

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

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
Escape(String) Escape(String) Escape(String) Escape(String)

文字列内の特殊文字を MSBuild エスケープ形式に変換します。Converts special characters in a string to MSBuild escape format.

GetGlobalProperty(String) GetGlobalProperty(String) GetGlobalProperty(String) GetGlobalProperty(String)

プロジェクト コレクションの指定した名前のグローバル プロパティを取得します。Gets any global property on the project collection that has the specified name.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetLoadedProjects(String) GetLoadedProjects(String) GetLoadedProjects(String) GetLoadedProjects(String)

指定したパスにプロジェクト パスが一致するすべてのプロジェクトを取得します。Gets all projects whose project path matches the given path.

GetToolset(String) GetToolset(String) GetToolset(String) GetToolset(String)

指定したツール バージョンのツールセットを取得します。Gets the toolset with the specified tools version.

GetType() GetType() GetType() GetType()

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

(Inherited from Object)
LoadProject(String) LoadProject(String) LoadProject(String) LoadProject(String)

指定したプロジェクト ファイルのソース コードからプロジェクトを評価します。Evaluates a project from the source code in the given project file. ソース コードは、このプロジェクト コレクションのグローバル プロパティとツール バージョンを使用して評価されます。The source code is evaluated with the global properties and tools version of this project collection.

LoadProject(String, IDictionary<String,String>, String) LoadProject(String, IDictionary<String,String>, String) LoadProject(String, IDictionary<String,String>, String) LoadProject(String, IDictionary<String,String>, String)

指定したプロジェクト ファイルからソース コードを読み取ってプロジェクトを評価します。Evaluates a project from the source code read from the given project file. ソース コードは、指定したグローバル プロパティとツール バージョンを使用して評価されます。The source code is evaluated with the given global properties and tools version.

LoadProject(String, String) LoadProject(String, String) LoadProject(String, String) LoadProject(String, String)

指定したプロジェクト ファイルからソース コードを読み取ってプロジェクトを評価します。Evaluates a project from the source code read from the given project file. ソース コードは、このプロジェクト コレクションのグローバル プロパティと、指定したツール バージョンを使用して評価されます。The source code is evaluated with the global properties of this project collection and the given tools version.

LoadProject(XmlReader) LoadProject(XmlReader) LoadProject(XmlReader) LoadProject(XmlReader)

指定した XML リーダーからソース コードを読み取ってプロジェクトを評価します。Evaluates a project from the source code read from the given XML reader. ソース コードは、このプロジェクト コレクションのグローバル プロパティとツール バージョンを使用して評価されます。The source code is evaluated with the global properties and tools version of this project collection.

LoadProject(XmlReader, IDictionary<String,String>, String) LoadProject(XmlReader, IDictionary<String,String>, String) LoadProject(XmlReader, IDictionary<String,String>, String) LoadProject(XmlReader, IDictionary<String,String>, String)

指定した XML リーダーからソース コードを読み取ってプロジェクトを評価します。Evaluates a project from the source code read from the given XML reader. ソース コードは、指定したグローバル プロパティとツール バージョンを使用して評価されます。The source code is evaluated with the given global properties and tools version.

LoadProject(XmlReader, String) LoadProject(XmlReader, String) LoadProject(XmlReader, String) LoadProject(XmlReader, String)

指定した XML リーダーからソース コードを読み取ってプロジェクトを評価します。Evaluates a project from the source code read from the given XML reader. ソース コードは、このプロジェクト コレクションのグローバル プロパティと、指定したツール バージョンを使用して評価されます。The source code is evaluated with the global properties of this project collection and the given tools version.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
RegisterForwardingLoggers(IEnumerable<ForwardingLoggerRecord>) RegisterForwardingLoggers(IEnumerable<ForwardingLoggerRecord>) RegisterForwardingLoggers(IEnumerable<ForwardingLoggerRecord>) RegisterForwardingLoggers(IEnumerable<ForwardingLoggerRecord>)

このコレクション内のプロジェクトのビルドに使用されるリモート ロガーのコレクションに、指定したリモート ロガーを追加します。Adds the given remote loggers to the collection of remote loggers used for builds of projects in this collection.

RegisterLogger(ILogger) RegisterLogger(ILogger) RegisterLogger(ILogger) RegisterLogger(ILogger)

このコレクション内のプロジェクトのビルドに使用されるロガーのコレクションに、指定したロガーを追加します。Adds the given logger to the collection of loggers used for builds of projects in this collection.

RegisterLoggers(IEnumerable<ILogger>) RegisterLoggers(IEnumerable<ILogger>) RegisterLoggers(IEnumerable<ILogger>) RegisterLoggers(IEnumerable<ILogger>)

このコレクション内のプロジェクトのビルドに使用されるロガーのコレクションに、指定した複数のロガーを追加します。Adds the given loggers to the collection of loggers used for builds of projects in this collection.

RemoveAllToolsets() RemoveAllToolsets() RemoveAllToolsets() RemoveAllToolsets()

プロジェクト コレクションからすべてのツールセットを削除します。Removes all toolsets from the project collection.

RemoveGlobalProperty(String) RemoveGlobalProperty(String) RemoveGlobalProperty(String) RemoveGlobalProperty(String)

既定のグローバル プロパティのセットからグローバル プロパティを削除します。Removes a global property from the set of default global properties.

RemoveToolset(String) RemoveToolset(String) RemoveToolset(String) RemoveToolset(String)

プロジェクト コレクションからツールセットを削除します。Removes a toolset from the project collection.

SetGlobalProperty(String, String) SetGlobalProperty(String, String) SetGlobalProperty(String, String) SetGlobalProperty(String, String)

既定のグローバル プロパティのセットに含まれているプロパティの値を設定します。Sets the value of a property in the default set of global properties.

ToString() ToString() ToString() ToString()

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

(Inherited from Object)
TryUnloadProject(ProjectRootElement) TryUnloadProject(ProjectRootElement) TryUnloadProject(ProjectRootElement) TryUnloadProject(ProjectRootElement)

コレクションからプロジェクトを削除することを試みます。Attempts to remove a project from the collection.

Unescape(String) Unescape(String) Unescape(String) Unescape(String)

文字列内のエスケープ文字を、特別な意味を持つ MSBuild の文字に変換します。Converts escaped characters in a string to MSBuild characters with special meaning.

UnloadAllProjects() UnloadAllProjects() UnloadAllProjects() UnloadAllProjects()

このプロジェクト コレクション内のプロジェクトをすべて削除します。Removes all projects in this project collection.

UnloadProject(Project) UnloadProject(Project) UnloadProject(Project) UnloadProject(Project)

指定したプロジェクトをプロジェクト コレクションから削除します。Removes the given project from the project collection.

UnloadProject(ProjectRootElement) UnloadProject(ProjectRootElement) UnloadProject(ProjectRootElement) UnloadProject(ProjectRootElement)

プロジェクト ルート要素をプロジェクト ルート キャッシュから削除します。Removes a project root element from the project root cache.

UnregisterAllLoggers() UnregisterAllLoggers() UnregisterAllLoggers() UnregisterAllLoggers()

このコレクション内のプロジェクトのビルドに使用されるロガーのコレクションから、すべてのロガーを削除します。Removes all loggers from the collection of loggers used by project builds in this collection.

イベント

ProjectAdded ProjectAdded ProjectAdded ProjectAdded

プロジェクトがこのプロジェクト コレクションの ProjectRootElementCache に追加されたときに発生するイベント。Event that is fired when a project is added to the ProjectRootElementCache of this project collection.

ProjectChanged ProjectChanged ProjectChanged ProjectChanged

このインスタンスに含まれる Project が直接変更されると発生します。Raised when a Project contained by this instance is directly changed.

ProjectCollectionChanged ProjectCollectionChanged ProjectCollectionChanged ProjectCollectionChanged

状態がこのインスタンスで変更されると発生します。Raised when state is changed on this instance.

ProjectXmlChanged ProjectXmlChanged ProjectXmlChanged ProjectXmlChanged

このインスタンスに含まれる ProjectRootElement が変更されると発生します。Raised when a ProjectRootElement contained by this instance is changed.

適用対象