Project Project Project Project Class

Definition

Warnung

Diese API ist jetzt veraltet.

Stellt ein Projekt dar, das mit MSBuild erstellt werden kann.Represents a project that can be built using MSBuild.

public ref class Project
[System.Obsolete("This class has been deprecated. Please use Microsoft.Build.Evaluation.Project from the Microsoft.Build assembly instead.")]
public class Project
type Project = class
Public Class Project
Vererbung
ProjectProjectProjectProject
Attribute

Hinweise

Ein Project stellt eine MSBuildMSBuild Projekt.A Project represents an MSBuildMSBuild project. Es ist ein Container für Elemente, Eigenschaften und Ziele.It is a container for items, properties and targets. Es kann projizieren von Inhalten aus speicherinternes XML oder aus einer XML-Datei, und Laden einer XML-Datei, die beibehalten werden, die meisten Leerzeichen und die XML-Kommentare speichern kann.It can load project content from in-memory XML or from an XML file, and can save to an XML file, preserving most white space and all XML comments.

Jede Project zugeordnet werden ein Engine Zugriff auf freigegebene Informationen.Every Project must be associated with an Engine to access shared information. Während eines Builds die Engine Objekt behält Überblick darüber, welche Projekte derzeit erstellt werden.During a build, the Engine object keeps track of which projects are currently building.

Konstruktoren

Project() Project() Project() Project()

Initialisiert eine neue Instanz der Project-Klasse.Initializes a new instance of the Project class.

Project(Engine) Project(Engine) Project(Engine) Project(Engine)

Initialisiert eine neue Instanz der Project-Klasse mit der bereitgestellten Engine.Initializes a new instance of the Project class using the supplied Engine.

Project(Engine, String) Project(Engine, String) Project(Engine, String) Project(Engine, String)

Initialisiert eine neue Instanz der Project-Klasse mit der bereitgestellten Engine und der bereitgestellten ToolsVersion.Initializes a new instance of the Project class using the supplied Engine and ToolsVersion.

Eigenschaften

BuildEnabled BuildEnabled BuildEnabled BuildEnabled

Ruft einen Wert ab, der angibt, ob das Erstellen von Aufgaben und Zielen im Projekt möglich ist, oder legt diesen fest.Gets or sets a value indicating whether the project is enabled for building tasks and targets.

DefaultTargets DefaultTargets DefaultTargets DefaultTargets

Ruft das DefaultTargets-Attribut des Project-Elements im MSBuildMSBuild-Projekt ab oder legt es fest.Gets or sets the DefaultTargets attribute of the Project element in the MSBuildMSBuild project.

DefaultToolsVersion DefaultToolsVersion DefaultToolsVersion DefaultToolsVersion

Legt im Project-Element der Projektdatei das ToolsVersion-XML-Attribut fest oder ruft dieses ab.Sets or gets the ToolsVersion XML attribute found on the Project element in the project file.

Encoding Encoding Encoding Encoding

Ruft die Codierung für die Projektdatei ab.Gets the encoding for the project file.

EvaluatedItems EvaluatedItems EvaluatedItems EvaluatedItems

Ruft eine Auflistung der Elemente ab, die während der Builderstellung ausgewertet werden.Gets a collection of the items evaluated during the build.

EvaluatedItemsIgnoringCondition EvaluatedItemsIgnoringCondition EvaluatedItemsIgnoringCondition EvaluatedItemsIgnoringCondition

Ruft eine Sammlung aller Elemente in einem Projekt ab, einschließlich der Elemente, die im Buildprozess nicht verwendet werden, weil ein Condition-Attribut als false ausgewertet wurde.Gets a collection of all items in a project, even those not used in the build process because a Condition attribute evaluated to false.

EvaluatedProperties EvaluatedProperties EvaluatedProperties EvaluatedProperties

Ruft eine Auflistung der Elemente ab, die während der Builderstellung ausgewertet werden.Gets a collection of the properties evaluated during the build.

FullFileName FullFileName FullFileName FullFileName

Ruft den vollqualifizierten Pfad und den Dateinamen der Projektdatei ab oder legt diesen fest.Gets or sets the fully qualified path and file name of the project file.

GlobalProperties GlobalProperties GlobalProperties GlobalProperties

Ruft eine Auflistung der globalen Eigenschaften für das Projekt ab oder legt diese fest.Gets or sets a collection of the global properties for the project.

HasToolsVersionAttribute HasToolsVersionAttribute HasToolsVersionAttribute HasToolsVersionAttribute

Ruft ab, ob die Projektdatei das ToolsVersion-XML-Attribut aufweist.Gets whether the Project file has the ToolsVersion XML attribute.

Imports Imports Imports Imports

Ruft die in dieses Projekt importierten Projekte ab.Gets the projects imported into this project.

InitialTargets InitialTargets InitialTargets InitialTargets

Ruft das InitialTargets-Attribut des Project-Elements im MSBuildMSBuild-Projekt ab oder legt es fest.Gets or sets the InitialTargets attribute of the Project element in the MSBuildMSBuild project.

IsDirty IsDirty IsDirty IsDirty

Ruft einen Wert ab, der angibt, ob sich das Projekt geändert hat und in einer Datei gespeichert werden muss.Gets a value indicating whether the project has changed and needs to be saved to a file.

IsValidated IsValidated IsValidated IsValidated

Ruft einen Wert ab, der angibt, ob das Projekt anhand eines Schemas überprüft werden soll.Gets a value indicating whether the project is to be validated against a schema.

ItemGroups ItemGroups ItemGroups ItemGroups

Ruft eine Sammlung der Elementgruppen ab, die mit dem ItemGroup-Element im Projekt angegeben werden.Gets a collection of the item groups specified with the ItemGroup element in the project.

ParentEngine ParentEngine ParentEngine ParentEngine

Ruft die Engine ab, mit der das Projekt erstellt wird.Gets the Engine that builds the project.

PropertyGroups PropertyGroups PropertyGroups PropertyGroups

Ruft eine Sammlung der Eigenschaftengruppen ab, die mit dem PropertyGroup-Element im Projekt angegeben werden.Gets a collection of the property groups specified with the PropertyGroup element in the project.

SchemaFile SchemaFile SchemaFile SchemaFile

Ruft eine XML-Schema-Datei ab, die bei der Überprüfung des Projekts verwendet werden soll, oder legt diese fest.Gets or sets the XML schema file to use when validating the project.

Targets Targets Targets Targets

Ruft die Ziele im Projekt ab.Gets the targets in the project.

TimeOfLastDirty TimeOfLastDirty TimeOfLastDirty TimeOfLastDirty

Ruft ein DateTime-Objekt ab, das den Zeitpunkt angibt, zu dem das Projekt zuletzt auf eine Weise geändert wurde, die das Speichern in einer Datei erforderlich macht.Gets a DateTime object indicating the time the project was last changed in a way that required it to be saved to a file.

ToolsVersion ToolsVersion ToolsVersion ToolsVersion

Legt die aktuelle Version des vom Projekt verwendeten Toolsets Flurstück oder ruft diese ab.Sets or gets the current version of the Toolset being used by the project.

UsingTasks UsingTasks UsingTasks UsingTasks

Ruft eine Sammlung der UsingTask-Elemente im Projekt ab.Gets a collection of the UsingTask elements in the project.

Xml Xml Xml Xml

Ruft den XML-Code ab, der das Projekt darstellt.Gets the XML representing the project.

Methoden

AddNewImport(String, String) AddNewImport(String, String) AddNewImport(String, String) AddNewImport(String, String)

Fügt am Ende des Projekts ein Import-Element hinzu.Adds an Import element to the end of the project.

AddNewItem(String, String) AddNewItem(String, String) AddNewItem(String, String) AddNewItem(String, String)

Fügt dem Projekt das angegebene Item-Element hinzu.Adds the specified Item element to the project.

AddNewItem(String, String, Boolean) AddNewItem(String, String, Boolean) AddNewItem(String, String, Boolean) AddNewItem(String, String, Boolean)

Fügt dem Projekt das angegebene Item-Element hinzu.Adds the specified Item element to the project.

AddNewItemGroup() AddNewItemGroup() AddNewItemGroup() AddNewItemGroup()

Fügt dem Projekt ein neues ItemGroup-Element hinzu.Adds a new ItemGroup element to the project.

AddNewPropertyGroup(Boolean) AddNewPropertyGroup(Boolean) AddNewPropertyGroup(Boolean) AddNewPropertyGroup(Boolean)

Fügt dem Projekt ein neues PropertyGroup-Element hinzu.Adds a new PropertyGroup element to the project.

AddNewUsingTaskFromAssemblyFile(String, String) AddNewUsingTaskFromAssemblyFile(String, String) AddNewUsingTaskFromAssemblyFile(String, String) AddNewUsingTaskFromAssemblyFile(String, String)

Fügt ein neues UsingTask-Element mit der angegebenen Assemblydatei ein.Adds a new UsingTask element with the specified assembly file.

AddNewUsingTaskFromAssemblyName(String, String) AddNewUsingTaskFromAssemblyName(String, String) AddNewUsingTaskFromAssemblyName(String, String) AddNewUsingTaskFromAssemblyName(String, String)

Fügt ein neues UsingTask-Element mit dem angegebenen Assemblynamen ein.Adds a new UsingTask element with the specified assembly name.

Build() Build() Build() Build()

Erstellt die Standardziele des Projekts.Builds the default targets of the project.

Build(String) Build(String) Build(String) Build(String)

Erstellt das angegebene Ziel im Projekt.Builds the specified target in the project.

Build(String[]) Build(String[]) Build(String[]) Build(String[])

Erstellt die angegebene Liste von Zielen im Projekt.Builds the specified list of targets in the project.

Build(String[], IDictionary) Build(String[], IDictionary) Build(String[], IDictionary) Build(String[], IDictionary)

Erstellt die angegebene Liste von Zielen im Projekt und gibt die Ausgaben der Ziele zurück.Builds the specified list of targets in the project, and returns the outputs of the targets.

Build(String[], IDictionary, BuildSettings) Build(String[], IDictionary, BuildSettings) Build(String[], IDictionary, BuildSettings) Build(String[], IDictionary, BuildSettings)

Erstellt anhand der angegebenen Einstellungen die angegebene Liste der Ziele im Projekt und gibt die Ausgaben der Ziele zurück.Builds the specified list of targets in the project using the specified settings, and returns the outputs of the targets.

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

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetConditionedPropertyValues(String) GetConditionedPropertyValues(String) GetConditionedPropertyValues(String) GetConditionedPropertyValues(String)

Gibt eine Liste möglicher Werte für die angegebene Eigenschaft zurück.Returns a list of possible values for the specified property.

GetEvaluatedItemsByName(String) GetEvaluatedItemsByName(String) GetEvaluatedItemsByName(String) GetEvaluatedItemsByName(String)

Gibt alle ausgewerteten Elemente zurück, die zur angegebenen Elementauflistung gehören.Returns all evaluated items belonging to the specified item collection.

GetEvaluatedItemsByNameIgnoringCondition(String) GetEvaluatedItemsByNameIgnoringCondition(String) GetEvaluatedItemsByNameIgnoringCondition(String) GetEvaluatedItemsByNameIgnoringCondition(String)

Gibt alle Elemente zurück, die zur angegebenen Elementsammlung gehören.Returns all items belonging to the specified item collection.

GetEvaluatedProperty(String) GetEvaluatedProperty(String) GetEvaluatedProperty(String) GetEvaluatedProperty(String)

Gibt den Wert der angegebenen Eigenschaft zurück.Returns the value of the specified property.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetProjectExtensions(String) GetProjectExtensions(String) GetProjectExtensions(String) GetProjectExtensions(String)

Gibt einen XML-Zeichenfolgenwert aus dem angegebenen Element im ProjectExtensions-Element zurück.Returns a string value of the XML from the specified element in the ProjectExtensions element.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
Load(String) Load(String) Load(String) Load(String)

Lädt den Inhalt der angegebenen Projektdatei in das Project-Objekt.Loads the contents of the specified project file into the Project object.

Load(String, ProjectLoadSettings) Load(String, ProjectLoadSettings) Load(String, ProjectLoadSettings) Load(String, ProjectLoadSettings)

Liest den Inhalt dieses Projekts von einer XML-Projektdatei auf dem Datenträger.Reads the contents of this project from a project XML file on disk.

Load(TextReader) Load(TextReader) Load(TextReader) Load(TextReader)

Lädt den Inhalt des angegebenen TextReader in das Project-Objekt.Loads the contents of the specified TextReader into the Project object.

Load(TextReader, ProjectLoadSettings) Load(TextReader, ProjectLoadSettings) Load(TextReader, ProjectLoadSettings) Load(TextReader, ProjectLoadSettings)

Liest den Inhalt dieses Projekts von einer Zeichenfolge mit dem XML-Inhalt.Reads the contents of this project from a string containing the XML contents.

LoadXml(String) LoadXml(String) LoadXml(String) LoadXml(String)

Lädt den Inhalt der angegebenen Zeichenfolge in das Project-Objekt.Loads the contents of the specified string into the Project object.

LoadXml(String, ProjectLoadSettings) LoadXml(String, ProjectLoadSettings) LoadXml(String, ProjectLoadSettings) LoadXml(String, ProjectLoadSettings)

Liest den Inhalt dieses Projekts von einer Zeichenfolge mit dem XML-Inhalt.Reads the contents of this project from a string containing the XML contents.

MarkProjectAsDirty() MarkProjectAsDirty() MarkProjectAsDirty() MarkProjectAsDirty()

Legt die IsDirty-Eigenschaft des Projekts auf true fest.Sets the IsDirty property of the project to true.

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

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
RemoveAllItemGroups() RemoveAllItemGroups() RemoveAllItemGroups() RemoveAllItemGroups()

Entfernt alle Elementgruppen aus dem Projekt, ändert jedoch keine importierten Projekte.Removes all item groups from the project, but does not modify imported projects.

RemoveAllPropertyGroups() RemoveAllPropertyGroups() RemoveAllPropertyGroups() RemoveAllPropertyGroups()

Entfernt alle Eigenschaftengruppen aus dem Projekt, ändert jedoch keine importierten Projekte.Removes all property groups from the project, but does not modify imported projects.

RemoveImportedPropertyGroup(BuildPropertyGroup) RemoveImportedPropertyGroup(BuildPropertyGroup) RemoveImportedPropertyGroup(BuildPropertyGroup) RemoveImportedPropertyGroup(BuildPropertyGroup)

Entfernt die angegebene Eigenschaftengruppe aus der Projekthauptdatei.Removes the specified property group from the main project file.

RemoveItem(BuildItem) RemoveItem(BuildItem) RemoveItem(BuildItem) RemoveItem(BuildItem)

Entfernt das angegebene Element aus dem Projekt.Removes the specified item from the project.

RemoveItemGroup(BuildItemGroup) RemoveItemGroup(BuildItemGroup) RemoveItemGroup(BuildItemGroup) RemoveItemGroup(BuildItemGroup)

Entfernt die angegebene Elementgruppe aus dem Projekt.Removes the specified item group from the project.

RemoveItemGroupsWithMatchingCondition(String) RemoveItemGroupsWithMatchingCondition(String) RemoveItemGroupsWithMatchingCondition(String) RemoveItemGroupsWithMatchingCondition(String)

Entfernt alle Elementgruppen mit der angegebenen Bedingung aus dem Projekt, ändert aber importierte Projekte nicht.Removes all item groups with the specified condition from the project, but does not modify imported projects.

RemoveItemsByName(String) RemoveItemsByName(String) RemoveItemsByName(String) RemoveItemsByName(String)

Entfernt alle Elemente in der angegebenen Elementauflistung aus dem Projekt, ändert jedoch keine importierten Projekte.Removes all items in the specified item collection from the project, but does not modify imported projects.

RemovePropertyGroup(BuildPropertyGroup) RemovePropertyGroup(BuildPropertyGroup) RemovePropertyGroup(BuildPropertyGroup) RemovePropertyGroup(BuildPropertyGroup)

Entfernt die angegebene Eigenschaftengruppe aus dem Projekt.Removes the specified property group from the project.

RemovePropertyGroupsWithMatchingCondition(String) RemovePropertyGroupsWithMatchingCondition(String) RemovePropertyGroupsWithMatchingCondition(String) RemovePropertyGroupsWithMatchingCondition(String)

Entfernt alle Eigenschaftsgruppen mit der angegebenen Bedingung aus dem Projekt, ändert aber importierte Projekte nicht.Removes all property groups with the specified condition from the project, but does not modify imported projects.

RemovePropertyGroupsWithMatchingCondition(String, Boolean) RemovePropertyGroupsWithMatchingCondition(String, Boolean) RemovePropertyGroupsWithMatchingCondition(String, Boolean) RemovePropertyGroupsWithMatchingCondition(String, Boolean)

Entfernt alle <PropertyGroups> (Eigenschaftengruppen) aus der Hauptprojektdatei, die eine bestimmte „Bedingung“ erfüllen.Removes all <PropertyGroup>'s from the main project file that have a specific "Condition."

ResetBuildStatus() ResetBuildStatus() ResetBuildStatus() ResetBuildStatus()

Setzt den Status sämtlicher Ziele im Projekt zurück, sodass alle Ziele bei der nächsten Builderstellung neu erstellt werden.Resets the status every target in the project so that the next build will build all targets again.

Save(String) Save(String) Save(String) Save(String)

Speichert das Objekt in der angegebenen Datei.Saves the project to the specified file.

Save(String, Encoding) Save(String, Encoding) Save(String, Encoding) Save(String, Encoding)

Speichert das Projekt in der angegebenen Datei mit der angegebenen Codierung.Saves the project in the specified file with the specified encoding.

Save(TextWriter) Save(TextWriter) Save(TextWriter) Save(TextWriter)

Speichert das Projekt im angegebenen TextWriter-Objekt.Saves the project in the specified TextWriter object.

SetImportedProperty(String, String, String, Project) SetImportedProperty(String, String, String, Project) SetImportedProperty(String, String, String, Project) SetImportedProperty(String, String, String, Project)

Legt den Wert einer Eigenschaft im angegebenen importierten Projekt fest.Sets the value of a property in the specified imported project.

SetImportedProperty(String, String, String, Project, PropertyPosition) SetImportedProperty(String, String, String, Project, PropertyPosition) SetImportedProperty(String, String, String, Project, PropertyPosition) SetImportedProperty(String, String, String, Project, PropertyPosition)

Legt den Wert einer Eigenschaft im angegebenen importierten Projekt fest.Sets the value of a property in the specified imported project.

SetImportedProperty(String, String, String, Project, PropertyPosition, Boolean) SetImportedProperty(String, String, String, Project, PropertyPosition, Boolean) SetImportedProperty(String, String, String, Project, PropertyPosition, Boolean) SetImportedProperty(String, String, String, Project, PropertyPosition, Boolean)

Legt den Wert einer Eigenschaft im angegebenen importierten Projekt fest.Sets the value of a property in the specified imported project.

SetProjectExtensions(String, String) SetProjectExtensions(String, String) SetProjectExtensions(String, String) SetProjectExtensions(String, String)

Legt das ProjectExtensions-Element des Projekts auf den angegebenen Elementnamen und -inhalt fest.Sets the ProjectExtensions element of the project with the specified element name and content.

SetProperty(String, String) SetProperty(String, String) SetProperty(String, String) SetProperty(String, String)

Legt den Wert der angegebenen Eigenschaft fest.Sets the value of the specified property.

SetProperty(String, String, String) SetProperty(String, String, String) SetProperty(String, String, String) SetProperty(String, String, String)

Legt den Wert der angegebenen Eigenschaft fest.Sets the value of the specified property.

SetProperty(String, String, String, PropertyPosition) SetProperty(String, String, String, PropertyPosition) SetProperty(String, String, String, PropertyPosition) SetProperty(String, String, String, PropertyPosition)

Legt den Wert der angegebenen Eigenschaft fest.Sets the value of the specified property.

SetProperty(String, String, String, PropertyPosition, Boolean) SetProperty(String, String, String, PropertyPosition, Boolean) SetProperty(String, String, String, PropertyPosition, Boolean) SetProperty(String, String, String, PropertyPosition, Boolean)

Legt den Wert der angegebenen Eigenschaft fest.Sets the value of the specified property.

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

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für: