Share via


ProjectTargetElement Class

Definition

ProjectTargetElement represents the Target element in the MSBuild project.

public ref class ProjectTargetElement : Microsoft::Build::Construction::ProjectElementContainer
public class ProjectTargetElement : Microsoft.Build.Construction.ProjectElementContainer
type ProjectTargetElement = class
    inherit ProjectElementContainer
Public Class ProjectTargetElement
Inherits ProjectElementContainer
Inheritance

Properties

AfterTargets

Gets or sets the AfterTargets value. Returns empty string if it is not present. Removes the attribute if the value to set is empty.

AfterTargetsLocation

Location of the AfterTargets attribute

AllChildren

Get an enumerator over all descendants in a depth-first manner.

(Inherited from ProjectElementContainer)
AllParents

All parent elements of this element, going up to the ProjectRootElement. None if this itself is a ProjectRootElement. None if this itself has not been attached to a parent yet.

(Inherited from ProjectElement)
BeforeTargets

Gets or sets the BeforeTargets value. Returns empty string if it is not present. Removes the attribute if the value to set is empty.

BeforeTargetsLocation

Location of the BeforeTargets attribute

Children

Get enumerable over all the children

(Inherited from ProjectElementContainer)
ChildrenReversed

Get enumerable over all the children, starting from the last

(Inherited from ProjectElementContainer)
Condition

Gets or sets the Condition value. It will return empty string IFF a condition attribute is legal but it’s not present or has no value. It will return null IFF a Condition attribute is illegal on that element. Removes the attribute if the value to set is empty. It is possible for derived classes to throw an InvalidOperationException if setting the condition is not applicable for those elements.

(Inherited from ProjectElement)
ConditionLocation

Location of the "Condition" attribute on this element, if any. If there is no such attribute, returns null.

(Inherited from ProjectElement)
ContainingProject

ProjectRootElement (possibly imported) that contains this Xml. Cannot be null.

(Inherited from ProjectElement)
Count

Number of children of any kind

(Inherited from ProjectElementContainer)
DependsOnTargets

Gets or sets the DependsOnTargets value. Returns empty string if it is not present. Removes the attribute if the value to set is empty.

DependsOnTargetsLocation

Location of the DependsOnTargets attribute

ElementName

Gets the name of the associated element. Useful for display in some circumstances.

(Inherited from ProjectElement)
FirstChild

First child, if any, otherwise null. Cannot be set directly; use PrependChild().

(Inherited from ProjectElementContainer)
Inputs

Gets or sets the Inputs value. Returns empty string if it is not present. Removes the attribute if the value to set is empty.

InputsLocation

Location of the Inputs attribute

ItemGroups

Get an enumerator over any child item groups

KeepDuplicateOutputs

Gets or sets the TrimDuplicateOutputs value. Returns empty string if it is not present. Removes the attribute if the value to set is empty.

KeepDuplicateOutputsLocation

Location of the TrimDuplicateOutputs attribute

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.

(Inherited from ProjectElement)
LabelLocation

Location of the "Label" attribute on this element, if any. If there is no such attribute, returns null;

(Inherited from ProjectElement)
LastChild

Last child, if any, otherwise null. Cannot be set directly; use AppendChild().

(Inherited from ProjectElementContainer)
Location

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.

(Inherited from ProjectElement)
Name

Gets and sets the name of the target element.

NameLocation

Location of the Name attribute

NextSibling

Next sibling element. May be null.

(Inherited from ProjectElement)
OnErrors

Get an enumerator over any child onerrors

OuterElement

The outer markup associated with this project element.

(Inherited from ProjectElement)
Outputs

Gets or sets the Outputs value. Returns empty string if it is not present. Removes the attribute if the value to set is empty.

OutputsLocation

Location of the Outputs attribute

Parent

Null if this is a ProjectRootElement. Null if this has not been attached to a parent yet.

(Inherited from ProjectElement)
PreviousSibling

Previous sibling element. May be null.

(Inherited from ProjectElement)
PropertyGroups

Get an enumerator over any child property groups

Returns

Gets or sets the Returns value. Returns null if the attribute is not present -- empty string is an allowable value for both getting and setting. Removes the attribute only if the value is set to null.

ReturnsLocation

Location of the Returns attribute

Tasks

Get an enumerator over any child tasks

Methods

AddItemGroup()

Convenience method that picks a location based on a heuristic: Adds an item group after the last child.

AddPropertyGroup()

Convenience method that picks a location based on a heuristic: Adds a property group after the last child.

AddTask(String)

Convenience method to add a task to this target. Adds after any existing task.

AppendChild(ProjectElement)

Inserts the provided element as the last child. Throws if the parent is not itself parented. Throws if the node to add is already parented. Throws if the node to add was created from a different project than this node.

(Inherited from ProjectElementContainer)
Clone()

Returns a shallow clone of this project element.

(Inherited from ProjectElement)
Clone(ProjectRootElement)

Returns a shallow clone of this project element.

(Inherited from ProjectElement)
CopyFrom(ProjectElement)

Applies properties from the specified type to this instance.

CopyFrom(ProjectElement)

Applies properties from the specified type to this instance.

(Inherited from ProjectElement)
CreateNewInstance(ProjectRootElement)

Returns a new instance of this same type. Any properties that cannot be set after creation should be set to copies of values as set for this instance.

CreateNewInstance(ProjectRootElement)

Returns a new instance of this same type. Any properties that cannot be set after creation should be set to copies of values as set for this instance.

(Inherited from ProjectElement)
DeepClone(ProjectRootElement, ProjectElementContainer)

Returns a clone of this project element and all its children.

(Inherited from ProjectElementContainer)
DeepCopyFrom(ProjectElementContainer)

Applies properties from the specified type to this instance.

(Inherited from ProjectElementContainer)
InsertAfterChild(ProjectElement, ProjectElement)

Insert the child after the reference child. Reference child if provided must be parented by this element. Reference child may be null, in which case this is equivalent to PrependChild(child). Throws if the parent is not itself parented. Throws if the reference node does not have this node as its parent. Throws if the node to add is already parented. Throws if the node to add was created from a different project than this node.

(Inherited from ProjectElementContainer)
InsertBeforeChild(ProjectElement, ProjectElement)

Insert the child before the reference child. Reference child if provided must be parented by this element. Reference child may be null, in which case this is equivalent to AppendChild(child). Throws if the parent is not itself parented. Throws if the reference node does not have this node as its parent. Throws if the node to add is already parented. Throws if the node to add was created from a different project than this node.

(Inherited from ProjectElementContainer)
PrependChild(ProjectElement)

Inserts the provided element as the first child. Throws if the parent is not itself parented. Throws if the node to add is already parented. Throws if the node to add was created from a different project than this node.

(Inherited from ProjectElementContainer)
RemoveAllChildren()

Remove all the children, if any.

(Inherited from ProjectElementContainer)
RemoveChild(ProjectElement)

Removes the specified child. Throws if the child is not currently parented by this object. This is O(1). May be safely called during enumeration of the children.

(Inherited from ProjectElementContainer)
ShouldCloneXmlAttribute(XmlAttribute)

Hook for subclasses to specify whether the given attribute should be cloned or not

(Inherited from ProjectElement)

Applies to