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)

Преобразует специальные символы в строку в escape-формате 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)

Преобразует escape-символы в строку символов 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.

Применяется к