ProjectRootElement Класс

Определение

Представляет проект MSBuild, файл целевых объектов или любой другой файл, соответствующий схеме файла проекта MSBuild.Represents an MSBuild project, a targets file, or any other file that conforms to MSBuild project file schema. Данный класс и связанные с ним классы позволяют считывать и записывать полный проект MSBuild и файл целевых объектов.This class and its related classes allow a complete MSBuild project or targets file to be read and written.

public ref class ProjectRootElement : Microsoft::Build::Construction::ProjectElementContainer
public class ProjectRootElement : Microsoft.Build.Construction.ProjectElementContainer
type ProjectRootElement = class
    inherit ProjectElementContainer
Public Class ProjectRootElement
Inherits ProjectElementContainer
Наследование

Комментарии

Комментарии и пробелы в настоящее время не могут быть изменены с помощью этой модели.Comments and white space cannot be edited through this model at present. Каждый корневой элемент проекта связан ровно с одной коллекцией проектов.Each project root element is associated with exactly one project collection. Это позволяет владельцу этой коллекции проектов контролировать свое время существования и не будет удивлен в результате изменений, поступающих из другой коллекции проектов.This allows the owner of that project collection to control its lifetime and not be surprised by edits that come from another project collection.

Свойства

AllChildren

Получает рекурсивный перечислитель преимущественно в глубину по всем дочерним элементам.Gets a recursive depth-first enumerator over all child elements.

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

Все родственные элементы данного элемента до ProjectRootElement.All parent elements of this element, going up to the ProjectRootElement.

Значение None, если это ProjectRootElement.None if this is a ProjectRootElement.

Значение none, если этот элемент еще не присоединен к родительскому элементу.None if this has not been attached to a parent yet.

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

Получает все дочерние элементы.Gets all child elements.

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

Получает все дочерние элементы, начиная с последнего элемента.Gets all child elements, starting from the last child.

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

Получает все дочерние элементы Choose (MSBuild) в этом проекте.Gets all child Choose Element (MSBuild) in this project.

Condition

Всегда возвращает значение null, поскольку атрибут Condition не существует для данного элемента, а несуществующее условие неявно дает значение true.Always returns null because the Condition attribute is nonexistent for this element, and a nonexistent condition is implicitly true.

ConditionLocation

Не используется.Do not use. Атрибут Condition не существует для ProjectRootElement.The Condition attribute is nonexistent for ProjectRootElement.

ContainingProject

ProjectRootElement (Возможно импортированный), содержащий этот Xml.ProjectRootElement (possibly imported) that contains this Xml.

Не может иметь значение NULL.Cannot be null.

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

Получает количество дочерних элементов.Gets the number of child elements.

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

Получает или задает значение атрибута DefaultTargets.Gets or sets the value of the DefaultTargets attribute.

DefaultTargetsLocation

Расположение атрибута DefaultTargets в этом элементе, если таковой имеется.Location of the DefaultTargets attribute on this element, if any.

DirectoryPath

Получает путь каталога к файлу проекта.Gets the directory path to the project file.

Encoding

Получает кодировку символов, в которой должен сохраняться файл проекта.Gets the character encoding that the project file is to be saved in.

FirstChild

Получает первый дочерний элемент.Gets the first child element.

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

Получает полный путь к файлу проекта.Gets the full path to the project file.

HasUnsavedChanges

Определяет, изменялся ли проект с момента последней загрузки или сохранения.Determines whether the project has been modified since it was last loaded or saved.

ImportGroups

Получает все группы импорта дочерних элементов в этом проекте.Gets all the child import groups in this project.

ImportGroupsReversed

Получает все группы импорта дочерних элементов в этом проекте, начиная с последней группы.Gets all the child import groups in this project, starting with the last group.

Imports

Получает все элементы импорта дочерних элементов в этом проекте.Gets all the child import elements in this project.

InitialTargets

Получает или задает значение атрибута InitialTargets.Gets or sets the value of the InitialTargets attribute.

InitialTargetsLocation

Расположение атрибута InitialTargets в этом элементе, если таковой имеется.Location of the InitialTargets attribute on this element, if any.

ItemDefinitionGroups

Получает все группы определений дочерних элементов в этом проекте.Gets all the child item definition groups in this project.

ItemDefinitionGroupsReversed

Получает все группы определений дочерних элементов в этом проекте, начиная с последней группы.Gets all the child item definition groups in this project, starting with the last group.

ItemDefinitions

Получает все определения дочерних элементов во всех группах определений в любой части этого проекта.Gets all child item definitions in all item definition groups anywhere in this project.

ItemGroups

Получает все группы дочерних элементов в этом проекте.Gets all the child item groups in this project.

ItemGroupsReversed

Получает все группы дочерних элементов в этом проекте, начиная с последней группы.Gets all the child item groups present in this project, starting with the last group.

Items

Получает все дочерние элементы в этом проекте.Gets all child items in this project.

Label

Получает или задает значение Label.Gets or sets the Label value.

Если атрибут не задан, возвращает пустую строку.Returns empty string if it is not present.

Удаляет атрибут, если задано пустое значение.Removes the attribute if the value to set is empty.

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

Расположение атрибута Label в этом элементе, если таковой имеется.Location of the "Label" attribute on this element, if any.

Если такого атрибута нет, возвращает значение NULL.If there is no such attribute, returns null;

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

Получает последний дочерний элемент.Gets the last child element.

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

Получает время последней записи файла проекта.Gets the last-write-time of the project file.

Location

Расположение соответствующего XML-элемента.Location of the corresponding Xml element.

Может быть неверным, если файл не сохранен или если файл был отредактирован с момента последнего сохранения.May not be correct if file is not saved, or file has been edited since it was last saved.

В случае несохраненной правки расположение содержит только путь к файлу, из которого происходит элемент.In the case of an unsaved edit, the location only contains the path to the file that the element originates from.

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

Следующий родственный элемент.Next sibling element.

Может принимать значение NULL.May be null.

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

Значение NULL, если это ProjectRootElement.Null if this is a ProjectRootElement.

Значение null, если этот элемент еще не присоединен к родительскому элементу.Null if this has not been attached to a parent yet.

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

Предыдущий родственный элемент.Previous sibling element.

Может принимать значение NULL.May be null.

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

Получает расположение исходного файла, а не какого-либо содержимого внутри него.Gets the location of the originating file itself, not any specific content within it. Если файл не получил имя, это пустое место.If the file has not been given a name, this is an empty location. Это правомерный случай отсутствия расположение.This is a legitimate case of having no location.

Properties

Получает все свойства дочерних элементов в этом проекте.Gets all the child properties in this project.

PropertyGroups

Получает все группы свойств дочерних элементов в этом проекте.Gets all the child property groups in this project.

PropertyGroupsReversed

Получает все группы свойств дочерних элементов в этом проекте, начиная с последней группы.Gets all the child property groups present in this project, starting with the last group.

RawXml

Получает XML-содержимое, представляющее данный проект.Gets the XML content that represents this project.

Targets

Получает все целевые дочерние элементы в этом проекте.Gets all the child targets in this project.

TimeLastChanged

Получает время последнего изменения данного проекта.Gets the time that this project was last modified.

ToolsVersion

Получает или задает значение атрибута ToolsVersion.Gets or sets the value of the ToolsVersion attribute.

ToolsVersionLocation

Получает расположение атрибута ToolsVersion в этом элементе, если таковой имеется.Gets the location of the ToolsVersion attribute on this element, if any.

TreatAsLocalProperty

Получает или задает значение атрибута TreatAsLocalProperty.Gets or sets the value of the TreatAsLocalProperty attribute.

TreatAsLocalPropertyLocation

Получает расположение атрибута TreatAsLocalProperty в этом элементе, если таковой имеется.Gets the location of the TreatAsLocalProperty attribute on this element, if any.

UsingTasks

Возвращает все дочерние элементы UsingTask (MSBuild) в этом проекте.Gets all child UsingTask Element (MSBuild) in this project.

Version

Получает номер версии данного объекта.Gets the version number of this object.

Методы

AddImport(String)

Добавляет импорт проекта в данный проект.Adds a project import to this project.

AddImportGroup()

Создает группу импорта в конце данного проекта.Creates an import group at the end of this project.

AddItem(String, String)

Добавляет элемент в данный проект.Adds an item to this project.

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

Добавляет элемент с метаданными в данный проект.Adds an item with metadata to this project.

AddItemDefinition(String)

Добавляет определение элемента в данный проект.Adds an item definition to this project.

AddItemDefinitionGroup()

Добавляет группу определений элемента в данный проект.Adds an item definition group to this project.

AddItemGroup()

Создает и добавляет группу элементов в данный проект.Creates and adds an item group to this project.

AddProperty(String, String)

Обновляет или добавляет свойство в данный проект.Updates or adds a property to this project.

AddPropertyGroup()

Добавляет новую группу свойств в данный проект.Adds a new property group to this project.

AddTarget(String)

Добавляет целевой объект в проект.Adds a target to the project.

AddUsingTask(String, String, String)

Добавляет в проект элемент UsingTask (MSBuild).Adds a UsingTask Element (MSBuild) to the project.

AppendChild(ProjectElement)

Добавляет элемент child в качестве последнего дочернего элемента данного контейнера проекта.Appends the child element as the last child of this project container.

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

Создает и инициализирует расположенный в памяти пустой экземпляр ProjectRootElement и добавляет его в коллекцию глобальных проектов.Creates and initializes an in-memory, empty ProjectRootElement instance and adds it to the global project collection.

Create(ProjectCollection)

Создает и инициализирует расположенный в памяти пустой экземпляр ProjectRootElement и добавляет его в указанную коллекцию проектов.Creates and initializes an in-memory, empty ProjectRootElement instance and adds it to the specified project collection.

Create(String)

Создает и инициализирует расположенный в памяти пустой экземпляр ProjectRootElement и добавляет его в коллекцию глобальных проектов.Creates and initializes an in-memory, empty ProjectRootElement instance and adds it to the global project collection. Корневая папка нового проекта инициализируется данными, найденными по указанному пути файла.The new project root is initialized from data found at the specified file path.

Create(String, ProjectCollection)

Создает и инициализирует расположенный в памяти пустой экземпляр ProjectRootElement и добавляет его в указанную коллекцию проектов.Creates and initializes an in-memory, empty ProjectRootElement instance and adds it to the specified project collection. Корневая папка нового проекта инициализируется данными, найденными по указанному пути файла.The new project root is initialized from data found at the specified file path.

Create(XmlReader)

Создает и инициализирует расположенный в памяти пустой экземпляр ProjectRootElement и добавляет его в коллекцию глобальных проектов.Creates and initializes an in-memory, empty ProjectRootElement instance and adds it to the global project collection. Корневая папка нового проекта инициализируется данными, считываемыми из указанного XmlReader.The new project root is initialized from data read from the specified XmlReader.

Create(XmlReader, ProjectCollection)

Создает и инициализирует расположенный в памяти пустой экземпляр ProjectRootElement и добавляет его в указанную коллекцию проектов.Creates and initializes an in-memory, empty ProjectRootElement instance and adds it to the specified project collection. Корневая папка нового проекта инициализируется данными, считываемыми из указанного XmlReader.The new project root is initialized from data read from the specified XmlReader.

CreateChooseElement()

Создает элемент Choose (MSBuild).Creates a Choose Element (MSBuild).

CreateImportElement(String)

Создает элемент Import (MSBuild).Creates an Import Element (MSBuild).

CreateImportGroupElement()

Создает группу импорта.Creates an import group.

CreateItemDefinitionElement(String)

Создает определение элемента.Creates an item definition.

CreateItemDefinitionGroupElement()

Создает группу определений элемента.Creates an item definition group.

CreateItemElement(String)

Создает элемент.Creates an item.

CreateItemElement(String, String)

Создает элемент с указанным значением Include.Creates an item with the specified Include value.

CreateItemGroupElement()

Создает группу элементов.Creates an item group.

CreateMetadataElement(String)

Создает узел метаданных с заданным именем.Creates a metadata node with the specified name.

CreateMetadataElement(String, String)

Создает узел метаданных с заданными именем и значением.Creates a metadata node with the specified name and value.

CreateOnErrorElement(String)

Создает элемент OnError (MSBuild).Creates an OnError Element (MSBuild).

CreateOtherwiseElement()

Создает элемент Otherwise (MSBuild).Creates an Otherwise Element (MSBuild). Вызывающий объект должен добавить его в выбранное расположение в проекте.Caller must add it to the location of choice in the project.

CreateOutputElement(String, String, String)

Создает элемент Output (MSBuild).Creates an Output Element (MSBuild).

CreateProjectExtensionsElement()

Создает элемент ProjectExtensions (MSBuild).Creates a ProjectExtensions Element (MSBuild).

CreatePropertyElement(String)

Создает свойство.Creates a property.

CreatePropertyGroupElement()

Создает группу свойств.Creates a property group.

CreateTargetElement(String)

Создает целевой объект.Creates a target.

CreateTaskElement(String)

Создает задачу.Creates a task.

CreateUsingTaskBodyElement(String, String)

Создает задачу, на которую должен ссылаться элемент UsingTask (MSBuild).Creates a task to be referenced by a UsingTask Element (MSBuild).

CreateUsingTaskElement(String, String, String)

Добавляет в проект элемент UsingTask (MSBuild).Adds a UsingTask Element (MSBuild) to the project.

CreateUsingTaskElement(String, String, String, String, String)

Добавляет в проект элемент UsingTask (MSBuild).Adds a UsingTask Element (MSBuild) to the project.

CreateUsingTaskParameterElement(String, String, String, String)

Создает параметр, который будет использоваться в группе параметров элемента UsingTask (MSBuild).Creates a parameter for use in a UsingTask Element (MSBuild) parameter group.

CreateUsingTaskParameterGroupElement()

Создает группу параметров для элемента UsingTask (MSBuild).Creates a parameter group for a UsingTask Element (MSBuild).

CreateWhenElement(String)

Создает элемент When (MSBuild) с заданным атрибутом Condition.Creates a When Element (MSBuild) with a specified Condition attribute.

Equals(Object)

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

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

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

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

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

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

Вставляет элемент child после элемента reference.Inserts the child element after the reference element.

(Унаследовано от ProjectElementContainer)
InsertBeforeChild(ProjectElement, ProjectElement)

Вставляет элемент child перед элементом reference.Inserts the child element before the reference element.

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

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

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

Инициализирует корневую папку в коллекции глобальных проектов, загружая данные из указанного пути файла.Initializes a project root in the global project collection by loading data from the specified file path.

Open(String, ProjectCollection)

Инициализирует корневую папку в указанной коллекции проектов, загружая данные из указанного пути файла.Initializes a project root in the specified project collection by loading data from the specified file path.

PrependChild(ProjectElement)

Добавляет элемент child в качестве первого дочернего элемента данного контейнера проекта.Prepends the child element as the first child of this project container.

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

Удаляет все существующие дочерние элементы из данного контейнера проекта.Removes all the children, if any, from this project container.

(Унаследовано от ProjectElementContainer)
RemoveChild(ProjectElement)

Удаляет элемент child из данного контейнера проекта.Removes a child element from this project container.

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

Если проект был изменен, сохраняет его в файловую систему.Saves the project, if modified, to the file system.

Save(Encoding)

Если проект был изменен, сохраняет его с заданной кодировкой символов.Saves the project, if modified, using the specified character encoding.

Save(String)

Сохраняет проект, если он был изменен или изменился путь файла для сохранения.Saves the project, if modified or if the file path to storage has changed.

Save(String, Encoding)

Сохраняет проект, если он был изменен или изменился путь файла для сохранения.Saves the project, if modified or if the file path to storage has changed. Использует указанную кодировку символов.Uses the specified character encoding.

Save(TextWriter)

Сохраняет проект в указанный модуль записи текста независимо от наличия изменений.Saves the project to the specified text writer, whether modified or not.

ToString()

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

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

Получает корневую папку в коллекции глобальных проектов, загруженную в память из указанного пути файла.Gets the project root in the global project collection that was loaded into memory from the specified file path.

TryOpen(String, ProjectCollection)

Получает корневую папку в указанной коллекции проектов, загруженную в память из указанного пути файла.Gets the project root in the specified project collection that was loaded into memory from the specified file path.

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