Project Класс

Определение

Представляет оцененный проект с семантикой времени разработки.Represents an evaluated project with design time semantics. Всегда создается резервный XML-файл. Он может быть построен напрямую, или экземпляр можно клонировать для добавления виртуальных элементов/свойств и сборки.Always backed by XML; can be built directly, or an instance can be cloned off to add virtual items/properties and build. Изменения в этом проекте всегда обновляют резервный XML-файл.Edits to this project always update the backing XML.

public ref class Project
public class Project
type Project = class
Public Class Project
Наследование
Project

Конструкторы

Project()

Создает пустой проект, оценивая его с помощью глобальных свойств глобальной коллекции проектов и версии инструментов по умолчанию.Construct an empty project, evaluating with the global project collection's global properties and default tools version. После получения имени проект будет добавлен в глобальную коллекцию проектов.Project will be added to the global project collection when it is named.

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

Создает пустой проект, оценивая его с помощью указанной коллекции проектов и глобальных свойств, а также версии инструментов по умолчанию, которые могут иметь значение NULL.Construct an empty project, evaluating with the specified project collection and the specified global properties and default tools version, either of which may be null. Проект будет добавлен в указанную коллекцию проектов после получения имени.Project will be added to the specified project collection when it is named.

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

Создает пустой проект, оценивая его с помощью указанной коллекции проектов и глобальных свойств, а также версии инструментов по умолчанию, которые могут иметь значение NULL.Construct an empty project, evaluating with the specified project collection and the specified global properties and default tools version, either of which may be null. Проект будет добавлен в указанную коллекцию проектов после получения имени.Project will be added to the specified project collection when it is named.

Project(NewProjectFileOptions)

Создает пустой проект, оценивая его с помощью глобальных свойств глобальной коллекции проектов и версии инструментов по умолчанию.Construct an empty project, evaluating with the global project collection's global properties and default tools version. После получения имени проект будет добавлен в глобальную коллекцию проектов.Project will be added to the global project collection when it is named.

Project(ProjectCollection)

Создает пустой проект, оценивая его с помощью глобальных свойств указанной коллекции проектов и версии инструментов по умолчанию.Construct an empty project, evaluating with the specified project collection's global properties and default tools version. Проект будет добавлен в указанную коллекцию проектов после получения имени.Project will be added to the specified project collection when it is named.

Project(ProjectCollection, NewProjectFileOptions)

Создает пустой проект, оценивая его с помощью глобальных свойств указанной коллекции проектов и версии инструментов по умолчанию.Construct an empty project, evaluating with the specified project collection's global properties and default tools version. Проект будет добавлен в указанную коллекцию проектов после получения имени.Project will be added to the specified project collection when it is named.

Project(ProjectRootElement)

Выполняет создание на основе объекта ProjectRootElement, оценивая его с помощью глобальных свойств из глобальной коллекции проектов и версии инструментов по умолчанию.Construct over a ProjectRootElement object, evaluating with the global project collection's global properties and default tools version. Проект добавляется в глобальную коллекцию проектов при наличии имени или после его получения.Project is added to the global project collection if it has a name, or else when it is named. Создает исключение InvalidProjectFileException, если вычисление завершается ошибкой.Throws InvalidProjectFileException if the evaluation fails. Создает исключение InvalidOperationException, если в коллекцию проектов уже загружен эквивалентный проект.Throws InvalidOperationException if there is already an equivalent project loaded in the project collection.

Project(ProjectRootElement, IDictionary<String,String>, String)

Выполняет создание на основе объекта ProjectRootElement, оценивая его с помощью указанных глобальных свойств и набора инструментов, которые могут иметь значение NULL.Construct over a ProjectRootElement object, evaluating with specified global properties and toolset, either or both of which may be null. Проект добавляется в глобальную коллекцию проектов при наличии имени или после его получения.Project is added to the global project collection if it has a name, or else when it is named. Создает исключение InvalidProjectFileException, если вычисление завершается ошибкой.Throws InvalidProjectFileException if the evaluation fails. Создает исключение InvalidOperationException, если в коллекцию проектов уже загружен эквивалентный проект.Throws InvalidOperationException if there is already an equivalent project loaded in the project collection.

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

Выполняет создание на основе объекта ProjectRootElement, оценивая его с помощью указанных глобальных свойств и набора инструментов, которые могут иметь значение NULL.Construct over a ProjectRootElement object, evaluating with specified global properties and toolset, either or both of which may be null. Проект добавляется в глобальную коллекцию проектов при наличии имени или после его получения.Project is added to the global project collection if it has a name, or else when it is named. Создает исключение InvalidProjectFileException, если вычисление завершается ошибкой.Throws InvalidProjectFileException if the evaluation fails. Создает исключение InvalidOperationException, если в коллекцию проектов уже загружен эквивалентный проект.Throws InvalidOperationException if there is already an equivalent project loaded in the project collection.

Project(ProjectRootElement, IDictionary<String,String>, String, ProjectCollection, ProjectLoadSettings)

Выполняет создание на основе объекта ProjectRootElement, оценивая его с помощью указанных глобальных свойств и набора инструментов, которые могут иметь значение NULL.Construct over a ProjectRootElement object, evaluating with specified global properties and toolset, either or both of which may be null. Проект добавляется в глобальную коллекцию проектов при наличии имени или после его получения.Project is added to the global project collection if it has a name, or else when it is named. Создает исключение InvalidProjectFileException, если вычисление завершается ошибкой.Throws InvalidProjectFileException if the evaluation fails. Создает исключение InvalidOperationException, если в коллекцию проектов уже загружен эквивалентный проект.Throws InvalidOperationException if there is already an equivalent project loaded in the project collection.

Project(ProjectRootElement, IDictionary<String,String>, String, String, ProjectCollection, ProjectLoadSettings)

Выполняет создание на основе объекта ProjectRootElement, оценивая его с помощью указанных глобальных свойств и набора инструментов, которые могут иметь значение NULL.Construct over a ProjectRootElement object, evaluating with specified global properties and toolset, either or both of which may be null. Проект добавляется в глобальную коллекцию проектов при наличии имени или после его получения.Project is added to the global project collection if it has a name, or else when it is named. Создает исключение InvalidProjectFileException, если вычисление завершается ошибкой.Throws InvalidProjectFileException if the evaluation fails. Создает исключение InvalidOperationException, если в коллекцию проектов уже загружен эквивалентный проект.Throws InvalidOperationException if there is already an equivalent project loaded in the project collection.

Project(String)

Выполняет создание на основе имеющегося файла проекта, оценивая его с помощью глобальных свойств из глобальной коллекции проектов и версии инструментов по умолчанию.Construct over an existing project file, evaluating with the global project collection's global properties and default tools version. Проект добавляется в глобальную коллекцию проектов.Project is added to the global project collection. Создает исключение InvalidProjectFileException, если вычисление завершается ошибкой.Throws InvalidProjectFileException if the evaluation fails. Создает исключение InvalidOperationException, если в коллекцию проектов уже загружен эквивалентный проект.Throws InvalidOperationException if there is already an equivalent project loaded in the project collection. Может создавать исключения, связанные с операциями ввода-вывода.May throw IO-related exceptions.

Project(String, IDictionary<String,String>, String)

Выполняет создание на основе имеющегося файла проекта, оценивая его с помощью указанных глобальных свойств и набора инструментов, которые могут иметь значение NULL.Construct over an existing project file, evaluating with specified global properties and toolset, either or both of which may be null. Проект добавляется в глобальную коллекцию проектов.Project is added to the global project collection. Создает исключение InvalidProjectFileException, если вычисление завершается ошибкой.Throws InvalidProjectFileException if the evaluation fails. Создает исключение InvalidOperationException, если в коллекцию проектов уже загружен эквивалентный проект.Throws InvalidOperationException if there is already an equivalent project loaded in the project collection. Может создавать исключения, связанные с операциями ввода-вывода.May throw IO-related exceptions.

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

Выполняет создание на основе имеющегося файла проекта, оценивая его указанные глобальные свойства и используя предоставленную версию инструментов, которые могут иметь значение NULL.Construct over an existing project file, evaluating with the specified global properties and using the tools version provided, either or both of which may be null. Проект добавляется в глобальную коллекцию проектов.Project is added to the global project collection. Создает исключение InvalidProjectFileException, если вычисление завершается ошибкой.Throws InvalidProjectFileException if the evaluation fails. Создает исключение InvalidOperationException, если в коллекцию проектов уже загружен эквивалентный проект.Throws InvalidOperationException if there is already an equivalent project loaded in the project collection. Может создавать исключения, связанные с операциями ввода-вывода.May throw IO-related exceptions.

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

Выполняет создание на основе имеющегося файла проекта, оценивая его указанные глобальные свойства и используя предоставленную версию инструментов, которые могут иметь значение NULL.Construct over an existing project file, evaluating with the specified global properties and using the tools version provided, either or both of which may be null. Проект добавляется в глобальную коллекцию проектов.Project is added to the global project collection. Создает исключение InvalidProjectFileException, если вычисление завершается ошибкой.Throws InvalidProjectFileException if the evaluation fails. Создает исключение InvalidOperationException, если в коллекцию проектов уже загружен эквивалентный проект.Throws InvalidOperationException if there is already an equivalent project loaded in the project collection. Может создавать исключения, связанные с операциями ввода-вывода.May throw IO-related exceptions.

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

Выполняет создание на основе имеющегося файла проекта, оценивая его указанные глобальные свойства и используя предоставленную версию инструментов, которые могут иметь значение NULL.Construct over an existing project file, evaluating with the specified global properties and using the tools version provided, either or both of which may be null. Проект добавляется в глобальную коллекцию проектов.Project is added to the global project collection. Создает исключение InvalidProjectFileException, если вычисление завершается ошибкой.Throws InvalidProjectFileException if the evaluation fails. Создает исключение InvalidOperationException, если в коллекцию проектов уже загружен эквивалентный проект.Throws InvalidOperationException if there is already an equivalent project loaded in the project collection. Может создавать исключения, связанные с операциями ввода-вывода.May throw IO-related exceptions.

Project(XmlReader)

Выполняет создание средства чтения текста для XML-проекта, оценивая его с помощью глобальных свойств из глобальной коллекции проектов и версии инструментов по умолчанию.Construct over a text reader over project xml, evaluating with the global project collection's global properties and default tools version. После получения имени проект будет добавлен в глобальную коллекцию проектов.Project will be added to the global project collection when it is named. Создает исключение InvalidProjectFileException, если вычисление завершается ошибкой.Throws InvalidProjectFileException if the evaluation fails. Создает исключение InvalidOperationException, если в коллекцию проектов уже загружен эквивалентный проект.Throws InvalidOperationException if there is already an equivalent project loaded in the project collection.

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

Выполняет создание средства чтения текста для XML-проекта, оценивая его с помощью указанных глобальных свойств и набора инструментов, которые могут иметь значение NULL.Construct over a text reader over project xml, evaluating with specified global properties and toolset, either or both of which may be null. После получения имени проект будет добавлен в глобальную коллекцию проектов.Project will be added to the global project collection when it is named. Создает исключение InvalidProjectFileException, если вычисление завершается ошибкой.Throws InvalidProjectFileException if the evaluation fails. Создает исключение InvalidOperationException, если в коллекцию проектов уже загружен эквивалентный проект.Throws InvalidOperationException if there is already an equivalent project loaded in the project collection.

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

Выполняет создание средства чтения текста для XML-проекта, оценивая его с помощью указанных глобальных свойств и набора инструментов, которые могут иметь значение NULL.Construct over a text reader over project xml, evaluating with specified global properties and toolset, either or both of which may be null. Проект будет добавлен в указанную коллекцию проектов после получения имени.Project will be added to the specified project collection when it is named. Создает исключение InvalidProjectFileException, если вычисление завершается ошибкой.Throws InvalidProjectFileException if the evaluation fails. Создает исключение InvalidOperationException, если в коллекцию проектов уже загружен эквивалентный проект.Throws InvalidOperationException if there is already an equivalent project loaded in the project collection.

Project(XmlReader, IDictionary<String,String>, String, ProjectCollection, ProjectLoadSettings)

Выполняет создание средства чтения текста для XML-проекта, оценивая его с помощью указанных глобальных свойств и набора инструментов, которые могут иметь значение NULL.Construct over a text reader over project xml, evaluating with specified global properties and toolset, either or both of which may be null. Проект будет добавлен в указанную коллекцию проектов после получения имени.Project will be added to the specified project collection when it is named. Создает исключение InvalidProjectFileException, если вычисление завершается ошибкой.Throws InvalidProjectFileException if the evaluation fails. Создает исключение InvalidOperationException, если в коллекцию проектов уже загружен эквивалентный проект.Throws InvalidOperationException if there is already an equivalent project loaded in the project collection.

Project(XmlReader, IDictionary<String,String>, String, String, ProjectCollection, ProjectLoadSettings)

Выполняет создание средства чтения текста для XML-проекта, оценивая его с помощью указанных глобальных свойств и набора инструментов, которые могут иметь значение NULL.Construct over a text reader over project xml, evaluating with specified global properties and toolset, either or both of which may be null. Проект будет добавлен в указанную коллекцию проектов после получения имени.Project will be added to the specified project collection when it is named. Создает исключение InvalidProjectFileException, если вычисление завершается ошибкой.Throws InvalidProjectFileException if the evaluation fails. Создает исключение InvalidOperationException, если в коллекцию проектов уже загружен эквивалентный проект.Throws InvalidOperationException if there is already an equivalent project loaded in the project collection.

Свойства

AllEvaluatedItemDefinitionMetadata

Метаданные определения элемента обнаружены во время оценки.Item definition metadata encountered during evaluation. Эти элементы считываются во время второго этапа оценки.These are read during the second evaluation pass. В отличие от тех, которые возвращаются свойством ItemDefinitions, они упорядочены и включают все метаданные, которые впоследствии были переопределены другими с тем же именем и типом элемента.Unlike those returned by the ItemDefinitions property, these are ordered, and include any metadata that were subsequently overridden by others with the same name and item type. Он не включает свойства, для условий которых не вычисляется значение true.It does not include any elements whose conditions did not evaluate to true. Она не включает метаданные определения элементов, добавленные после последней оценки.It does not include any item definition metadata added since the last evaluation.

AllEvaluatedItems

Элементы, обнаруженные во время оценки.Items encountered during evaluation. Эти элементы считываются во время третьего этапа оценки.These are read during the third evaluation pass. В отличие от элементов, возвращаемых свойством Items, эти упорядочиваются по отношению ко всем остальным элементам, обнаруженным во время оценки, а не только по отношению к элементам одного типа.Unlike those returned by the Items property, these are ordered with respect to all other items encountered during evaluation, not just ordered with respect to items of the same item type. В некоторых приложениях, таких как язык F#, это полное взаимное упорядочение является существенным и такие узлы могут использовать это свойство.In some applications, like the F# language, this complete mutual ordering is significant, and such hosts can use this property. Он не включает свойства, для условий которых не вычисляется значение true.It does not include any elements whose conditions did not evaluate to true. Он не включает элементы, добавленные после последней оценки.It does not include any items added since the last evaluation.

AllEvaluatedProperties

Свойства, обнаруженные во время оценки.Properties encountered during evaluation. Эти элементы считываются во время первого этапа оценки.These are read during the first evaluation pass. В отличие от тех, которые возвращаются свойством Properties, они упорядочены и включают все свойства, которые впоследствии были переопределены другими с тем же именем.Unlike those returned by the Properties property, these are ordered, and includes any properties that were subsequently overridden by others with the same name. Он не включает свойства, для свойств которых не вычисляется значение true.It does not include any properties whose conditions did not evaluate to true. Он не включает все свойства, добавленные с момента последней оценки.It does not include any properties added since the last evaluation.

ConditionedProperties

Коллекция возможных значений, подразумеваемых для свойств, содержащихся в условиях, обнаруживаемых для свойств, групп свойств, операций импорта и объектов When.Collection of possible values implied for properties contained in the conditions found on properties, property groups, imports, and whens.

Например, если в свойствах проекта существовали следующие условия:For example, if the following conditions existed on properties in a project: Condition="'$(Configuration)|$(Platform)' == 'Debug|x86'" Condition="'$(Configuration)' == 'Release'",Condition="'$(Configuration)|$(Platform)' == 'Debug|x86'" Condition="'$(Configuration)' == 'Release'" в таблице будет указаноthe table would be populated with { "Configuration", { "Debug", "Release" }} { "Platform", { "x86" }}{ "Configuration", { "Debug", "Release" }} { "Platform", { "x86" }} Используется в Visual Studio для определения конфигураций, определенных в проекте.This is used by Visual Studio to determine the configurations defined in the project.

DirectoryPath

Корневой каталог для этого проекта.The root directory for this project. Никогда не может принимать значение NULL. Проекты в памяти используют текущий каталог во время загрузки.Is never null: in-memory projects use the current directory from the time of load.

DisableMarkDirty

Является ли MarkDirty() временно отключенным.Whether MarkDirty() is temporarily disabled. Это позволяет, например, установить глобальное свойство, не помечая проект как "грязный" для выполнения впоследствии повторной оценки.This allows, for example, a global property to be set without the project getting marked dirty for reevaluation as a consequence.

EvaluationCounter

Является устаревшей.Obsolete. Взамен рекомендуется использовать LastEvaluationId.Use LastEvaluationId instead.

FullPath

Полный путь к файлу проекта.The full path to this project's file. Может иметь значение NULL, если проект не был загружен с диска.May be null, if the project was not loaded from disk. Метод задания переименовывает проект, если у него уже было имя.Setter renames the project, if it already had a name.

GlobalProperties

Словарь только для чтения глобальных свойств, используемых в оценке этого проекта.Read only dictionary of the global properties used in the evaluation of this project.

Imports

Все файлы, которые во время оценки участвовали в этом проекте, такие как ProjectRootElements с ProjectImportElement, что вызвало их импорт.All the files that during evaluation contributed to this project, as ProjectRootElements, with the ProjectImportElement that caused them to be imported. Сюда не включаются проекты, которые никогда не импортировались из-за того, что условие в элементе Import принимало значение false.This does not include projects that were never imported because a condition on an Import element was false. Внешний ProjectRootElement, сопоставляемый с этим проектом, не включается.The outer ProjectRootElement that maps to this project itself is not included.

ImportsIncludingDuplicates

Этот список будет содержать дубликаты импортированных элементов, если они импортируются несколько раз.This list will contain duplicate imports if an import is imported multiple times. Однако только первый импорт используется при оценке.However, only the first import was used in evaluation.

IsBuildEnabled

Контролирует, включена ли в этом проекте сборка целевых объектов или задач.This controls whether or not the building of targets/tasks is enabled for this project. Этот механизм нужен для целей безопасности и позволяет узлу точно контролировать, какие проекты в нем могут выполнять целевые объекты и задачи.This is for security purposes in case a host wants to closely control which projects it allows to run targets/tasks. По умолчанию для созданного проекта будет использоваться любой параметр, находящийся в родительской коллекции проектов.By default, for a newly created project, we will use whatever setting is in the parent project collection. Если сборка отключена, метод построения для этого класса завершится ошибкой.When build is disabled, the Build method on this class will fail. Однако если узел уже создал ProjectInstance, он по-прежнему может выполнять сборку.However if the host has already created a ProjectInstance, it can still build it. (Для этого можно выполнить такую же проверку при необходимости.)(It is free to put a similar check around where it does this.)

IsDirty

Является ли этот проект настолько "грязным", что нуждается в повторной оценке.Whether this project is dirty such that it needs reevaluation. Это может быть вызвано тем, что базовый XML изменился (либо в этом проекте, либо в другом) либо в XML-коде основного проекта, либо в импортированном файле. Или же изменен его набор инструментов.This may be because its underlying XML has changed (either through this project or another) either the XML of the main project or an imported file; or because its toolset may have changed.

ItemDefinitions

Доступный только для чтения словарь определений элементов в этом проекте.Read-only dictionary of item definitions in this project. Ключом является тип элементов.Keyed by item type

Items

Элементы в этом проекте, упорядоченные внутри групп типов элементов.Items in this project, ordered within groups of item types

ItemsIgnoringCondition

Элементы в этом проекте, упорядоченные внутри групп типов элементов, включая элементы, условия которых были оценены как ложные или которые содержались в группах элементов, которые сами были условно оценены как ложные.Items in this project, ordered within groups of item types, including items whose conditions evaluated to false, or that were contained within item groups who themselves had conditioned evaluated to false. Это полезно для узлов, настроенных на отображение всех элементов, даже тех, которые не являются частью сборки в текущей конфигурации.This is useful for hosts that wish to display all items, even if they might not be part of the build in the current configuration.

ItemTypes

Типы элементов в этом проекте.Item types in this project. Это упорядоченная коллекция.This is an ordered collection.

LastEvaluationId

Идентификатор последней оценки для этого проекта.The ID of the last evaluation for this Project. Проект всегда оценивается при построении. Затем его можно оценить несколько раз с помощью ReevaluateIfNecessary().A project is always evaluated upon construction and can subsequently get evaluated multiple times via ReevaluateIfNecessary()

Это произвольное число, которое изменяется при повторной оценке этого проекта.It is an arbitrary number that changes when this project reevaluates. Узлам неизвестно, действительно ли оценка происходила в течение интервала, но они могут сравнить это число с ранее сохраненным значением, чтобы выяснить это, и если это так, то, возможно, обновить собственное состояние.Hosts don't know whether an evaluation actually happened in an interval, but they can compare this number to their previously stored value to find out, and if so perhaps decide to update their own state. Обратите внимание, что число не может увеличиваться монотонно.Note that the number may not increase monotonically.

Это значение соответствуетThis number corresponds to the и может использоваться для подключения событий ведения журнала оценки к экземпляру проекта.and can be used to connect evaluation logging events back to the Project instance.

ProjectCollection

Получает или задает коллекцию проектов, содержащую этот проект.Gets or sets the project collection which contains this project. Не может иметь значение NULL.Can never be null. Нельзя изменить.Cannot be modified.

ProjectFileLocation

Расположение самого исходного файла, а не конкретного содержимого в нем.Location of the originating file itself, not any specific content within it. Если файл не получил имя, возвращает пустое расположение.If the file has not been given a name, returns an empty location.

Properties

Свойства в этом проекте.Properties in this project. После оценки это неупорядоченная коллекция.Since evaluation has occurred, this is an unordered collection.

SkipEvaluation

Является ли ReevaluateIfNecessary временно отключенным.Whether ReevaluateIfNecessary is temporarily disabled. Это может быть полезным, если узел ожидает выполнения ряда считываний и записей в проект и целесообразно пожертвовать правильностью для увеличения производительности.This is useful when the host expects to make a number of reads and writes to the project, and wants to temporarily sacrifice correctness for performance.

SubToolsetVersion

Версия вложенного набора инструментов, скомбинированная с ToolsVersion, использовалась для указания свойств набора инструментов для этого проекта.The sub-toolset version that, combined with the ToolsVersion, was used to determine the toolset properties for this project.

Targets

Целевые объекты в проекте.Targets in the project. Ключом к словарю является имя целевого объекта.The key to the dictionary is the target's name. Переопределенные целевые объекты не включены в эту коллекцию.Overridden targets are not included in this collection. Эта коллекция доступна только для чтения.This collection is read-only.

ThrowInsteadOfSplittingItemElement

Определенные операции с элементами разбивают элемент item на несколько элементов, если include содержит стандартные маски, ссылки на элементы, свойства или несколько значений элементов.Certain item operations split the item element in multiple elements if the include contains globs, references to items or properties, or multiple item values.

Ниже перечислены операции с элементами, которые могут расширять элементы элементов. RemoveItem(ProjectItem) - RemoveItems(IEnumerable<ProjectItem>) - AddItem(String, String, IEnumerable<KeyValuePair<String,String>>) - AddItemFast(String, String, IEnumerable<KeyValuePair<String,String>>) - Rename(String) - RemoveMetadata(String) - SetMetadataValue(String, String) - SetMetadataValue(String, String, Boolean)The items operations that may expand item elements are: - RemoveItem(ProjectItem) - RemoveItems(IEnumerable<ProjectItem>) - AddItem(String, String, IEnumerable<KeyValuePair<String,String>>) - AddItemFast(String, String, IEnumerable<KeyValuePair<String,String>>) - Rename(String) - RemoveMetadata(String) - SetMetadataValue(String, String) - SetMetadataValue(String, String, Boolean)

Если для этого свойства задано значение true, то при выполнении предыдущих операций элемента вместо распространения элемента item выдается исключение .When this property is set to true, the previous item operations throw an instead of expanding the item element.

ToolsVersion

Версия инструментов, использованная для оценки проекта, если таковая имеется.The tools version this project was evaluated with, if any. Не всегда совпадает с версией инструментов в теге Project, если таковая имеется. Это значение может определяться извне, например с помощью аргумента /tv.Not necessarily the same as the tools version on the Project tag, if any; it may have been externally specified, for example with a /tv switch. Фактическую версию инструментов в теге проекта можно получить из Xml.The actual tools version on the Project tag, can be gotten from Xml. Невозможно изменить после создания проекта.Cannot be changed once the project has been created.

Xml

Резервный проект XML.The backing Xml project. Не может иметь значение NULL.Can never be null

Методы

AddItem(String, String)

Добавляет элемент без метаданных в проект.Adds an item with no metadata to the project. В дальнейшем можно добавить любые метаданные.Any metadata can be added subsequently. Не изменяет XML-код, если выражение с подстановочным знаком уже включает новый элемент.Does not modify the XML if a wildcard expression would already include the new item. Выполняет вычисление наилучшим возможным образом: распространяется на все элементы.Evaluates on a best-effort basis: -expands with all items. Могут использоваться элементы, определенные в XML-коде под новым элементом, даже если в реальной оценке их не будет.Items that are defined in the XML below the new item may be used, even though in a real evaluation they would not be. вычисляется только этот элемент.-only this item is evaluated. Другие элементы, которые могут зависеть от него, не затрагиваются.Other items that might depend on it is not affected. Понятно, что это условие не обязательно оставляет проект в полностью самосогласованном состоянии до повторной оценки.This is a convenience that it is understood does not necessarily leave the project in a perfectly self consistent state until reevaluation.

AddItem(String, String, IEnumerable<KeyValuePair<String,String>>)

Добавляет элемент с метаданными в проект.Adds an item with metadata to the project. Метаданные могут иметь значение null, что означает отсутствие метаданных.Metadata may be null, indicating no metadata. Не изменяет XML-код, если выражение с подстановочным знаком уже включает новый элемент.Does not modify the XML if a wildcard expression would already include the new item. Выполняет вычисление наилучшим возможным образом: распространяется на все элементы.Evaluates on a best-effort basis: -expands with all items. Могут использоваться элементы, определенные в XML-коде под новым элементом, даже если в реальной оценке их не будет.Items that are defined in the XML below the new item may be used, even though in a real evaluation they would not be. вычисляется только этот элемент.-only this item is evaluated. Другие элементы, которые могут зависеть от него, не затрагиваются.Other items that might depend on it is not affected. Понятно, что это условие не обязательно оставляет проект в полностью самосогласованном состоянии до повторной оценки.This is a convenience that it is understood does not necessarily leave the project in a perfectly self consistent state until reevaluation.

AddItemFast(String, String)

Добавляет элемент без метаданных в проект.Adds an item with no metadata to the project. Не пытается определить, соответствует ли существующий подстановочный знак новому элементу за исключением случаев, если это первый элемент в группе элементов.Makes no effort to see if an existing wildcard would already match the new item, unless it is the first item in an item group. Не пытается найти новый элемент рядом с аналогичными элементами.Makes no effort to locate the new item near similar items. Добавляет элемент к первой группе элементов, которая не имеет условия и не имеет дочерних элементов или первый дочерний элемент которой является элементом того же типа.Appends the item to the first item group that does not have a condition and has either no children or whose first child is an item of the same type. Выполняет вычисление наилучшим возможным образом: распространяется на все элементы.Evaluates on a best-effort basis: -expands with all items. Могут использоваться элементы, определенные в XML-коде под новым элементом, даже если в реальной оценке их не будет.Items that are defined in the XML below the new item may be used, even though in a real evaluation they would not be. вычисляется только этот элемент.-only this item is evaluated. Другие элементы, которые могут зависеть от него, не затрагиваются.Other items that might depend on it is not affected. Понятно, что это условие не обязательно оставляет проект в полностью самосогласованном состоянии до повторной оценки.This is a convenience that it is understood does not necessarily leave the project in a perfectly self consistent state until reevaluation.

AddItemFast(String, String, IEnumerable<KeyValuePair<String,String>>)

Добавляет элемент с метаданными в проект.Adds an item with metadata to the project. Метаданные могут иметь значение null, что означает отсутствие метаданных.Metadata may be null, indicating no metadata. Не пытается определить, соответствует ли существующий подстановочный знак новому элементу за исключением случаев, если это первый элемент в группе элементов.Makes no effort to see if an existing wildcard would already match the new item, unless it is the first item in an item group. Не пытается найти новый элемент рядом с аналогичными элементами.Makes no effort to locate the new item near similar items. Добавляет элемент к первой группе элементов, которая не имеет условия и не имеет дочерних элементов или первый дочерний элемент которой является элементом того же типа.Appends the item to the first item group that does not have a condition and has either no children or whose first child is an item of the same type. Выполняет вычисление наилучшим возможным образом: распространяется на все элементы.Evaluates on a best-effort basis: -expands with all items. Могут использоваться элементы, определенные в XML-коде под новым элементом, даже если в реальной оценке их не будет.Items that are defined in the XML below the new item may be used, even though in a real evaluation they would not be. вычисляется только этот элемент.-only this item is evaluated. Другие элементы, которые могут зависеть от него, не затрагиваются.Other items that might depend on it is not affected. Понятно, что это условие не обязательно оставляет проект в полностью самосогласованном состоянии до повторной оценки.This is a convenience that it is understood does not necessarily leave the project in a perfectly self consistent state until reevaluation.

Build()

Запускает сборку с помощью этого проекта, создавая целевые объекты по умолчанию.Starts a build using this project, building the default targets. Возвращает значение true, если операция выполнена успешно; в противном случае — значение false.Returns true on success, false on failure. Работает на частном клонированном экземпляре.Works on a privately cloned instance. Чтобы задать или получить виртуальные элементы для целей сборки, нужно явно клонировать экземпляр и выполнить его сборку.To set or get virtual items for build purposes, clone an instance explicitly and build that. Не изменяет объект Project.Does not modify the Project object.

Build(IEnumerable<ILogger>)

Запускает сборку с помощью этого проекта, создавая целевые объекты по умолчанию и указанные средства ведения журнала.Starts a build using this project, building the default targets and the specified loggers. Возвращает значение true, если операция выполнена успешно; в противном случае — значение false.Returns true on success, false on failure. Работает на частном клонированном экземпляре.Works on a privately cloned instance. Чтобы задать или получить виртуальные элементы для целей сборки, нужно явно клонировать экземпляр и выполнить его сборку.To set or get virtual items for build purposes, clone an instance explicitly and build that. Не изменяет объект Project.Does not modify the Project object.

Build(IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>)

Запускает сборку с помощью этого проекта, создавая целевые объекты по умолчанию и указанные средства ведения журнала.Starts a build using this project, building the default targets and the specified loggers. Возвращает значение true, если операция выполнена успешно; в противном случае — значение false.Returns true on success, false on failure. Работает на частном клонированном экземпляре.Works on a privately cloned instance. Чтобы задать или получить виртуальные элементы для целей сборки, нужно явно клонировать экземпляр и выполнить его сборку.To set or get virtual items for build purposes, clone an instance explicitly and build that. Не изменяет объект Project.Does not modify the Project object.

Build(ILogger)

Запускает сборку с помощью этого проекта, создавая целевые объекты по умолчанию и указанное средство ведения журнала.Starts a build using this project, building the default targets and the specified logger. Возвращает значение true, если операция выполнена успешно; в противном случае — значение false.Returns true on success, false on failure. Работает на частном клонированном экземпляре.Works on a privately cloned instance. Чтобы задать или получить виртуальные элементы для целей сборки, нужно явно клонировать экземпляр и выполнить его сборку.To set or get virtual items for build purposes, clone an instance explicitly and build that. Не изменяет объект Project.Does not modify the Project object.

Build(String)

Запускает сборку с помощью этого проекта, создавая указанный целевой объект.Starts a build using this project, building the specified target. Возвращает значение true, если операция выполнена успешно; в противном случае — значение false.Returns true on success, false on failure. Работает на частном клонированном экземпляре.Works on a privately cloned instance. Чтобы задать или получить виртуальные элементы для целей сборки, нужно явно клонировать экземпляр и выполнить его сборку.To set or get virtual items for build purposes, clone an instance explicitly and build that. Не изменяет объект Project.Does not modify the Project object.

Build(String, IEnumerable<ILogger>)

Запускает сборку с помощью этого проекта, создавая указанный целевой объект с определенными средствами ведения журнала.Starts a build using this project, building the specified target with the specified loggers. Возвращает значение true, если операция выполнена успешно; в противном случае — значение false.Returns true on success, false on failure. Работает на частном клонированном экземпляре.Works on a privately cloned instance. Чтобы задать или получить виртуальные элементы для целей сборки, нужно явно клонировать экземпляр и выполнить его сборку.To set or get virtual items for build purposes, clone an instance explicitly and build that. Не изменяет объект Project.Does not modify the Project object.

Build(String, IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>)

Запускает сборку с помощью этого проекта, создавая указанный целевой объект с определенными средствами ведения журнала.Starts a build using this project, building the specified target with the specified loggers. Возвращает значение true, если операция выполнена успешно; в противном случае — значение false.Returns true on success, false on failure. Работает на частном клонированном экземпляре.Works on a privately cloned instance. Чтобы задать или получить виртуальные элементы для целей сборки, нужно явно клонировать экземпляр и выполнить его сборку.To set or get virtual items for build purposes, clone an instance explicitly and build that. Не изменяет объект Project.Does not modify the Project object.

Build(String[])

Запускает сборку с помощью этого проекта, создавая указанные целевые объекты.Starts a build using this project, building the specified targets. Возвращает значение true, если операция выполнена успешно; в противном случае — значение false.Returns true on success, false on failure. Работает на частном клонированном экземпляре.Works on a privately cloned instance. Чтобы задать или получить виртуальные элементы для целей сборки, нужно явно клонировать экземпляр и выполнить его сборку.To set or get virtual items for build purposes, clone an instance explicitly and build that. Не изменяет объект Project.Does not modify the Project object.

Build(String[], IEnumerable<ILogger>)

Запускает сборку с помощью этого проекта, создавая указанные целевые объекты с указанными средствами ведения журнала.Starts a build using this project, building the specified targets with the specified loggers. Возвращает значение true, если операция выполнена успешно; в противном случае — значение false.Returns true on success, false on failure. Если сборка отключена в этом проекте, она не выполняется и возвращает значения false.If build is disabled on this project, does not build, and returns false. Работает на частном клонированном экземпляре.Works on a privately cloned instance. Чтобы задать или получить виртуальные элементы для целей сборки, нужно явно клонировать экземпляр и выполнить его сборку.To set or get virtual items for build purposes, clone an instance explicitly and build that. Не изменяет объект Project.Does not modify the Project object.

Build(String[], IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>)

Запускает сборку с помощью этого проекта, создавая указанные целевые объекты с указанными средствами ведения журнала.Starts a build using this project, building the specified targets with the specified loggers. Возвращает значение true, если операция выполнена успешно; в противном случае — значение false.Returns true on success, false on failure. Если сборка отключена в этом проекте, она не выполняется и возвращает значения false.If build is disabled on this project, does not build, and returns false. Работает на частном клонированном экземпляре.Works on a privately cloned instance. Чтобы задать или получить виртуальные элементы для целей сборки, нужно явно клонировать экземпляр и выполнить его сборку.To set or get virtual items for build purposes, clone an instance explicitly and build that. Не изменяет объект Project.Does not modify the Project object.

Build(String[], IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>, EvaluationContext)

См. раздел Build(String[], IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>).See Build(String[], IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>)

CreateProjectInstance()

Возвращает экземпляр на основе данного проекта, но полностью отсоединенный.Returns an instance based on this project, but completely disconnected. Этот экземпляр можно использовать для независимой сборки.This instance can be used to build independently. Перед созданием экземпляра при необходимости будет выполняться повторная оценка проекта, поэтому он не будет "грязным".Before creating the instance, this will reevaluate the project if necessary, so it will not be dirty.

CreateProjectInstance(ProjectInstanceSettings)

Возвращает экземпляр на основе данного проекта, но полностью отсоединенный.Returns an instance based on this project, but completely disconnected. Этот экземпляр можно использовать для независимой сборки.This instance can be used to build independently. Перед созданием экземпляра при необходимости будет выполняться повторная оценка проекта, поэтому он не будет "грязным".Before creating the instance, this will reevaluate the project if necessary, so it will not be dirty. Экземпляр является неизменяемым; ни один из объектов, которые формируют его, не может быть изменен.The instance is immutable; none of the objects that form it can be modified. Это обеспечивает безопасность параллельного доступа из нескольких потоков.This makes it safe to access concurrently from multiple threads.

CreateProjectInstance(ProjectInstanceSettings, EvaluationContext)

См. раздел CreateProjectInstance(ProjectInstanceSettings).See CreateProjectInstance(ProjectInstanceSettings)

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
ExpandString(String)

Оценивает предоставленную строку, разворачивая элементы и свойства, как если бы она находилась в самом конце файла проекта.Evaluates the provided string by expanding items and properties, as if it was found at the very end of the project file. Это полезно для некоторых узлов, для которых достаточно наилучшей оценки.This is useful for some hosts for which this kind of best-effort evaluation is sufficient. Не расширяет простые выражения метаданных.Does not expand bare metadata expressions.

FromFile(String, ProjectOptions)

Создает проект на основе файлов.Create a file based project.

FromProjectRootElement(ProjectRootElement, ProjectOptions)

Создает проект на основе ProjectRootElement.Create a ProjectRootElement based project.

FromXmlReader(XmlReader, ProjectOptions)

Создает проект на основе XmlReader.Create a XmlReader based project.

GetAllGlobs()

Находит все стандартные маски, указанные во включенных элементах.Finds all the globs specified in item includes.

GetAllGlobs(EvaluationContext)

См. раздел GetAllGlobs().See GetAllGlobs()

GetAllGlobs(String)

Перегрузка GetAllGlobs()Overload of GetAllGlobs()

GetAllGlobs(String, EvaluationContext)

См. раздел GetAllGlobs(String).See GetAllGlobs(String)

GetEvaluatedItemIncludeEscaped(ProjectItem)

Возвращает вычисленное экранированное значение элемента Include из предоставленного элемента.Returns the evaluated, escaped value of the provided item's include.

GetEvaluatedItemIncludeEscaped(ProjectItemDefinition)

Возвращает вычисленное экранированное значение элемента Include из определения предоставленного элемента.Returns the evaluated, escaped value of the provided item definition's include.

GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetItemProvenance(ProjectItem)

Перегрузка GetItemProvenance(String)Overload of GetItemProvenance(String)

GetItemProvenance(ProjectItem, EvaluationContext)

См. раздел GetItemProvenance(ProjectItem).See GetItemProvenance(ProjectItem)

GetItemProvenance(String)

Находит все элементы item в логическом проекте с itemspecs, которые соответствуют заданной строке: элементы, которые включают (или исключают) строку; элементы, которые будут обновлять строку (еще не реализовано); элементы, которые будут удалять строку (еще не реализовано).Finds all the item elements in the logical project with itemspecs that match the given string: - elements that would include (or exclude) the string - elements that would update the string (not yet implemented) - elements that would remove the string (not yet implemented)

GetItemProvenance(String, EvaluationContext)

См. раздел GetItemProvenance(String).See GetItemProvenance(String)

GetItemProvenance(String, String)

Перегрузка GetItemProvenance(String)Overload of GetItemProvenance(String)

GetItemProvenance(String, String, EvaluationContext)

См. раздел GetItemProvenance(String, String).See GetItemProvenance(String, String)

GetItems(String)

Все элементы в проекте указанного типа.All the items in the project of the specified type. При отсутствии таких элементов возвращает пустой список.If there are none, returns an empty list. Используйте AddItem или RemoveItem, чтобы изменить элементы в проекте.Use AddItem or RemoveItem to modify items in this project.

GetItemsByEvaluatedInclude(String)

Возвращает все элементы с указанным оцененным включением.Returns all items that have the specified evaluated include. Например, все элементы с оцененным включением "bar.cpp".For example, all items that have the evaluated include "bar.cpp". Как правило, это может быть ноль или один, но иногда существует два элемента с одинаковым путем и различными типами элементов или даже теми же типами элементов.Typically there will be zero or one, but sometimes there are two items with the same path and different item types, or even the same item types. Все они будут возвращены.This will return them all.

GetItemsIgnoringCondition(String)

Все элементы в проекте указанного типа, независимо от того, были ли условия для них оценены как true.All the items in the project of the specified type, irrespective of whether the conditions on them evaluated to true. Этот список доступен только для чтения. Используйте AddItem или RemoveItem, чтобы изменить элементы в проекте.This is a read-only list: use AddItem or RemoveItem to modify items in this project.

GetLogicalProject()

Возвращает итератор по логическому проекту.Returns an iterator over the "logical project". Логический проект определяется как неоцененный проект, полученный из единого файла MSBuild, созданного в результате включения текста всех импортов исходного файла манифеста проекта MSBuild.The logical project is defined as the unevaluated project obtained from the single MSBuild file that is the result of inlining the text of all imports of the original MSBuild project manifest file.

GetMetadataValueEscaped(ProjectItem, String)

Получает преобразованное в escape-последовательность значение метаданных с заданным именем для указанного элемента.Gets the escaped value of the metadatum with the provided name on the provided item.

GetMetadataValueEscaped(ProjectItemDefinition, String)

Получает преобразованное в escape-последовательность значение метаданных с заданным именем для указанного определения элемента.Gets the escaped value of the metadatum with the provided name on the provided item definition.

GetMetadataValueEscaped(ProjectMetadata)

Получает преобразованное в escape-последовательность значение указанных метаданных.Gets the escaped value of the provided metadatum.

GetProperty(String)

Возвращает все свойства в проекте с указанным именем; в противном случае возвращает значение NULL.Get any property in the project that has the specified name, otherwise returns null

GetPropertyValue(String)

Возвращает значение без escape-последовательности свойства в этом проекте или пустую строку, если она не существует.Get the unescaped value of a property in this project, or an empty string if it does not exist.

GetPropertyValueEscaped(ProjectProperty)

Получает экранированное значение указанного свойства.Get the escaped value of the provided property

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MarkDirty()

Вызывается для принудительной пометки проекта как "грязного" и нуждающегося в повторной оценке.Called to forcibly mark the project as dirty requiring reevaluation. Обычно это необязательно для установки. Все изменения, влияющие на этот проект, автоматически делают его "грязным".Generally this is not necessary to set; all edits affecting this project will automatically make it dirty. Однако есть потенциальные тупиковые случаи, когда необходимо пометить проект как "грязный" напрямую.However there are potential corner cases where it is necessary to mark the project dirty directly. Например, если в проекте есть условный импорт в имеющийся на диске файл, но файл не существовал во время оценки, то после того, как он будет создан, проект не сможет понять, что повторная оценка будет продуктивной.For example, if the project has an import conditioned on a file existing on disk, and the file did not exist at evaluation time, then someone subsequently creates that file, the project cannot know that reevaluation would be productive. В этом случае узел может помочь нам, установив флаг "Грязный" явным образом, чтобы ReevaluateIfNecessary() мог распознать необходимость в оценке.In such a case the host can help us by setting the dirty flag explicitly so that ReevaluateIfNecessary() will recognize an evaluation is indeed necessary. Не помечает базовый файл проекта как нуждающийся в сохранении.Does not mark the underlying project file as requiring saving.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ReevaluateIfNecessary()

Повторная оценка проекта, чтобы вернуть его в запрашиваемое состояние, если он "грязный".Reevaluate the project to get it into a queryable state, if it's dirty. Это включает все изменения, ранее внесенные в резервный XML при редактировании этого проекта.This incorporates all changes previously made to the backing XML by editing this project. Создает исключение InvalidProjectFileException, если вычисление завершается ошибкой.Throws InvalidProjectFileException if the evaluation fails.

ReevaluateIfNecessary(EvaluationContext)

См. раздел ReevaluateIfNecessary().See ReevaluateIfNecessary()

RemoveGlobalProperty(String)

Удаляет глобальное свойство.Removes a global property. Если оно было задано, возвращает значение true и помечает проект как нуждающийся в повторной оценке.If it was set, returns true, and marks the project as requiring reevaluation.

RemoveItem(ProjectItem)

Удаляет элемент из проекта.Removes an item from the project. Элемент должен быть связан с этим проектом.Item must be associated with this project. Элемент не должен поступать из импортированного файла.Item must not originate from an imported file. Возвращает значение true, если элемент находился в этом оцененном проекте; в противном случае — значение false.Returns true if the item was in this evaluated project, otherwise false. Для удобства, если родительская группа элементов становится пустой, она также удаляется.As a convenience, if the parent item group becomes empty, it is also removed. Если элемент поступил из выражения с подстановочными знаками или с разделителями точка с запятой, сначала разворачивает это выражение на несколько элементов.If the item originated from a wildcard or semicolon separated expression, expands that expression into multiple items first. Обновляет оцененный проект, но не затрагивает другие данные в проекте до повторной оценки.Updates the evaluated project, but does not affect anything else in the project until reevaluation. Например, если удаляется элемент типа "i", то "j", который вычисляется после "@(i)", не будет изменен до повторной оценки.For example, if an item of type "i" is removed, "j" which is evaluated from "@(i)" will not be modified until reevaluation. Понятно, что это условие не обязательно оставляет проект в полностью самосогласованном состоянии до повторной оценки.This is a convenience that it is understood does not necessarily leave the project in a perfectly self consistent state until reevaluation.

RemoveItems(IEnumerable<ProjectItem>)

Удаляет все указанные элементы из проекта.Removes all the specified items from the project. Элементы, не связанные с этим проектом, пропускаются.Items that are not associated with this project are skipped.

RemoveProperty(ProjectProperty)

Удаляет указанное свойство.Removes the specified property. Свойство должно быть связано с этим проектом.Property must be associated with this project. Свойство не должно поступать из импортированного файла.Property must not originate from an imported file. Возвращает значение true, если свойство находилось в этом оцененном проекте; в противном случае — значение false.Returns true if the property was in this evaluated project, otherwise false. Для удобства, если родительская группа свойств становится пустой, она также удаляется.As a convenience, if the parent property group becomes empty, it is also removed. Обновляет оцененный проект, но не затрагивает другие данные в проекте до повторной оценки.Updates the evaluated project, but does not affect anything else in the project until reevaluation. Например, если удалить элемент "p", он будет удален из оцененного проекта, но "q", который вычисляется из "$(p)", не будет изменен до повторной оценки.For example, if "p" is removed, it will be removed from the evaluated project, but "q" which is evaluated from "$(p)" will not be modified until reevaluation. Это сделано для удобства, но при этом следует понимать, что проект не всегда будет в полностью согласованном состоянии.This is a convenience that it is understood does not necessarily leave the project in a perfectly self consistent state.

Save()

Сохраняет проект в файловую систему, если он "грязный".Save the project to the file system, if dirty. Использует кодировку по умолчанию.Uses the default encoding.

Save(Encoding)

Сохраняет проект в файловую систему, если он "грязный".Save the project to the file system, if dirty.

Save(String)

Сохраняет проект в файловую систему при наличии несохраненных изменений или отличии пути.Save the project to the file system, if dirty or the path is different. Использует кодировку по умолчанию.Uses the default encoding.

Save(String, Encoding)

Сохраняет проект в файловую систему при наличии несохраненных изменений или отличии пути.Save the project to the file system, if dirty or the path is different.

Save(TextWriter)

Сохраняет проект в указанное средство TextWriter, независимо от того, является ли он "грязным".Save the project to the provided TextWriter, whether or not it is dirty. Использует кодировку TextWriter.Uses the encoding of the TextWriter. Удаляет флаг "Грязный".Clears the Dirty flag.

SaveLogicalProject(TextWriter)

Сохраняет "логический" или "предварительно обработанный" файл проекта, включающий все импортированные файлы так, как если бы они составляли единый файл.Saves a "logical" or "preprocessed" project file, that includes all the imported files as if they formed a single file.

SetGlobalProperty(String, String)

Изменение глобального свойства после оценки проекта.Change a global property after the project has been evaluated. Если значение изменяется, требуется повторная оценка для проекта.If the value changes, this makes the project require reevaluation. Если значение изменяется, возвращает значение true; в противном случае — false.If the value changes, returns true, otherwise false.

SetProperty(String, String)

Задает или добавляет свойство с указанным именем и значением.Set or add a property with the specified name and value. Переопределяет значение любого свойства с таким же именем, которое уже имеется в коллекции, если оно не происходит из импортированного файла.Overwrites the value of any property with the same name already in the collection if it did not originate in an imported file. Если такого свойства нет, использует эвристика: обновляет последнее имеющееся свойство указанным именем, если для него и его группы свойств нет условий (если таковые имеются), и находится в этом файле проекта, а не в импортированном файле.If there is no such existing property, uses this heuristic: Updates the last existing property with the specified name that has no condition on itself or its property group, if any, and is in this project file rather than an imported file. В противном случае добавляет новое свойство в первую группу свойств без условия, при необходимости создавая группу свойств после последней имеющейся группы свойств, в противном случае — в начале проекта.Otherwise, adds a new property in the first property group without a condition, creating a property group if necessary after the last existing property group, else at the start of the project. Возвращает набор свойств.Returns the property set. Выполняет вычисление наилучшим возможным образом: распространяется на все свойства.Evaluates on a best-effort basis: -expands with all properties. Могут использоваться свойства, определенные в XML-коде под новым свойством, даже если в реальной оценке их не будет.Properties that are defined in the XML below the new property may be used, even though in a real evaluation they would not be. вычисляется только это свойство.-only this property is evaluated. Все остальное, которое может зависеть от его значения, не затрагивается.Anything else that would depend on its value is not affected. Понятно, что это условие не обязательно оставляет проект в полностью самосогласованном состоянии до повторной оценки.This is a convenience that it is understood does not necessarily leave the project in a perfectly self consistent state until reevaluation.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

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