ProjectCollection ProjectCollection ProjectCollection ProjectCollection Class

Definition

Kapselt einen Satz von verwandten Projekten, ihre Toolsets, einen Standardsatz globaler Eigenschaften und die Protokollierungen, die zum Erstellen verwendet werden sollen.Encapsulates a set of related projects, their toolsets, a default set of global properties, and the loggers that should be used to build them. Eine globale Version dieser Klasse fungiert als Standardprojektauflistung.A global version of this class acts as the default project collection.

public ref class ProjectCollection : IDisposable
public class ProjectCollection : IDisposable
type ProjectCollection = class
    interface IDisposable
Public Class ProjectCollection
Implements IDisposable
Vererbung
ProjectCollectionProjectCollectionProjectCollectionProjectCollection
Implementiert

Hinweise

Mehrere projektauflistungen können in eine app-Domäne vorhanden sein.Multiple project collections can exist within an app domain. Allerdings müssen diese nicht gleichzeitig erstellen.However, these must not build concurrently.

Konstruktoren

ProjectCollection() ProjectCollection() ProjectCollection() ProjectCollection()

Erstellt eine Projektauflistung ohne globale Eigenschaften oder Protokollierungen.Creates a project collection with no global properties or loggers. Das Projektauflistungstoolset wird aus der Konfigurationsdatei und der Registrierung initialisiert.The project collection toolset is initialized from the configuration file and registry.

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

Instanziiert eine Projektauflistung mit angegebenen globalen Eigenschaften und ohne Protokollierungen, die Toolsetinformationen aus der Konfigurationsdatei und der Registrierung liest.Instantiates a project collection with specified global properties, no loggers, and that reads toolset information from the configuration file and registry.

ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>, ToolsetDefinitionLocations, Int32, Boolean) ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>, ToolsetDefinitionLocations, Int32, Boolean) ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>, ToolsetDefinitionLocations, Int32, Boolean) ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>, ToolsetDefinitionLocations, Int32, Boolean)

Erstellt eine Projektauflistung mit den angegebenen globalen Eigenschaften, Protokollierungen, Knotenanzahl und onlyLogCriticalEvents-Wert.Creates a project collection with specified global properties, loggers, node count, and onlyLogCriticalEvents value. Das Projektauflistungstoolset wird aus Toolsets an den angegebenen Speicherorten initialisiert.The project collection toolset is initialized from toolsets in the given locations.

ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, ToolsetDefinitionLocations) ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, ToolsetDefinitionLocations) ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, ToolsetDefinitionLocations) ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, ToolsetDefinitionLocations)

Instanziiert eine Projektauflistung mit angegebenen globalen Eigenschaften und Protokollierungen unter Verwendung der angegebenen Toolsetspeicherorte.Instantiates a project collection with specified global properties and loggers and using the specified toolset locations.

ProjectCollection(ToolsetDefinitionLocations) ProjectCollection(ToolsetDefinitionLocations) ProjectCollection(ToolsetDefinitionLocations) ProjectCollection(ToolsetDefinitionLocations)

Erstellt eine Projektauflistung ohne globale Eigenschaften oder Protokollierungen.Creates a project collection with no global properties or loggers. Das Projektauflistungstoolset wird aus Toolsets an den angegebenen Speicherorten initialisiert.The project collection toolset is initialized from toolsets in the given locations.

Eigenschaften

Count Count Count Count

Ruft die Anzahl der gegenwärtig in diese Auflistung geladenen Projekte ab.Gets the number of projects currently loaded into this collection.

DefaultToolsVersion DefaultToolsVersion DefaultToolsVersion DefaultToolsVersion

Ruft die Standardtoolsversion dieser Projektauflistung ab.Gets the default tools version of this project collection.

DisableMarkDirty DisableMarkDirty DisableMarkDirty DisableMarkDirty

Ruft ein Flag ab, das bestimmt, ob MarkDirty() für Projekte in dieser Auflistung vorübergehend deaktiviert ist, oder legt es fest.Gets or sets a flag that determines whether MarkDirty() is temporarily disabled on projects in this collection. Dies ermöglicht z. B. das Festlegen globaler Eigenschaften, ohne dass Projekte für eine erneute Auswertung entsprechend als geändert markiert werden.This allows, for example, a global properties to be set without projects getting marked dirty for reevaluation as a consequence.

GlobalProjectCollection GlobalProjectCollection GlobalProjectCollection GlobalProjectCollection

Ruft das globale Projektauflistungsobjekt ab.Gets the global project collection object.

GlobalProperties GlobalProperties GlobalProperties GlobalProperties

Ruft die schreibgeschützten globalen Standardeigenschaften für alle Projekte in dieser Auflistung ab.Gets the read-only default global properties for all projects in this collection.

HostServices HostServices HostServices HostServices

Ruft ein Objekt ab, das während der Buildvorgänge von in der Projektauflistung enthaltenen Projekten Hostdienste für Aufgaben bereitstellt, oder legt es fest.Gets or sets an object that provides host services to tasks during builds of projects contained in the project collection.

IsBuildEnabled IsBuildEnabled IsBuildEnabled IsBuildEnabled

Ruft einen Wert ab, der angibt, ob die Ziele und die Tasks von Projekten in der Projektcollection erstellt werden können, oder legt diesen fest.Gets or sets a value that indicates whether the targets and tasks of projects in the project collection can be built.

LoadedProjects LoadedProjects LoadedProjects LoadedProjects

Ruft alle gegenwärtig in dieser Auflistung geladenen Projekte ab.Gets all the projects currently loaded into this collection.

Loggers Loggers Loggers Loggers

Ruft alle Protokollierungen ab, die Projekte in dieser Auflistung für ihre Builds verwenden können.Gets all loggers that projects in this collection can use for their builds.

OnlyLogCriticalEvents OnlyLogCriticalEvents OnlyLogCriticalEvents OnlyLogCriticalEvents

Ruft einen Wert ab, der angibt, ob nur wichtige Ereignisse wie Warnungen und Fehler protokolliert werden, oder legt ihn fest.Gets or sets a value that indicates whether only critical events such as warnings and errors are logged.

SkipEvaluation SkipEvaluation SkipEvaluation SkipEvaluation

Ruft einen Wert ab, der angibt, ob ReevaluateIfNecessary für Projekte in dieser Collection vorübergehend deaktiviert ist, oder legt diesen fest.Gets or sets a value the indicates whether ReevaluateIfNecessary is temporarily disabled on projects in this collection. Dies ist nützlich, wenn der Host Lese- und Schreibvorgänge für Projekte erwartet und vorübergehend Richtigkeit zugunsten von Leistung geopfert werden soll.This is useful when the host expects to make a number of reads and writes to projects, and wants to temporarily sacrifice correctness for performance.

ToolsetLocations ToolsetLocations ToolsetLocations ToolsetLocations

Ruft die Speicherorte ab, die zur Suche nach den Toolsets verwendet wurden.Gets the locations used to find the toolsets.

Toolsets Toolsets Toolsets Toolsets

Ruft die für diese Projektauflistung verfügbaren Toolsets ab.Gets the toolsets available to this project collection.

Version Version Version Version

Ruft die Dateiversion der Assemblydatei ab, die die MSBuild-Engine enthält.Gets the file version of the assembly file that contains the MSBuild engine.

Methoden

AddToolset(Toolset) AddToolset(Toolset) AddToolset(Toolset) AddToolset(Toolset)

Fügt der Projektauflistung ein neues Toolset hinzu.Adds a new toolset to the project collection. Ersetzt ein vorhandenes Toolset durch die gleiche Toolsversion.Replaces any existing toolset with the same tools version.

ContainsToolset(String) ContainsToolset(String) ContainsToolset(String) ContainsToolset(String)

Bestimmt, ob ein Toolset für die angegebene Toolsversion definiert ist.Determines whether a toolset is defined for the given tools version.

Dispose() Dispose() Dispose() Dispose()

Gibt verwaltete und nicht verwaltete Ressourcen frei.Releases both managed and unmanaged resources. Wird aufgerufen, wenn ein Host die Projektauflistung nicht mehr benötigt.Called when a host no longer needs the project collection.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt verwaltete und nicht verwaltete Ressourcen frei.Releases both managed and unmanaged resources. Wird aufgerufen, wenn ein Host die Projektauflistung nicht mehr benötigt.Called when a host no longer needs the project collection. Beendet alle Protokollierdienste, die die Projektauflistung besitzt, und gibt den Protokollierthread frei.Shuts down any logging services that the project collection owns and releases the logger thread.

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)
Escape(String) Escape(String) Escape(String) Escape(String)

Konvertiert Sonderzeichen in einer Zeichenfolge in das MSBuild-Escapeformat.Converts special characters in a string to MSBuild escape format.

GetGlobalProperty(String) GetGlobalProperty(String) GetGlobalProperty(String) GetGlobalProperty(String)

Ruft eine globale Eigenschaft in der Projektcollection ab, die über den angegebenen Namen verfügt.Gets any global property on the project collection that has the specified name.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetLoadedProjects(String) GetLoadedProjects(String) GetLoadedProjects(String) GetLoadedProjects(String)

Ruft alle Projekte ab, deren Projektpfad mit dem angegebenen Pfad übereinstimmt.Gets all projects whose project path matches the given path.

GetToolset(String) GetToolset(String) GetToolset(String) GetToolset(String)

Ruft das Toolset mit der angegebenen Toolversion ab.Gets the toolset with the specified tools version.

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

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

(Inherited from Object)
LoadProject(String) LoadProject(String) LoadProject(String) LoadProject(String)

Wertet ein Projekt aus dem Quellcode in der angegebenen Projektdatei aus.Evaluates a project from the source code in the given project file. Der Quellcode wird mit den globalen Eigenschaften und der Toolsversion dieser Projektauflistung ausgewertet.The source code is evaluated with the global properties and tools version of this project collection.

LoadProject(String, IDictionary<String,String>, String) LoadProject(String, IDictionary<String,String>, String) LoadProject(String, IDictionary<String,String>, String) LoadProject(String, IDictionary<String,String>, String)

Wertet ein Projekt anhand des aus der angegebenen Projektdatei gelesenen Quellcodes aus.Evaluates a project from the source code read from the given project file. Der Quellcode wird mit den angegebenen globalen Eigenschaften und der Toolsversion ausgewertet.The source code is evaluated with the given global properties and tools version.

LoadProject(String, String) LoadProject(String, String) LoadProject(String, String) LoadProject(String, String)

Wertet ein Projekt anhand des aus der angegebenen Projektdatei gelesenen Quellcodes aus.Evaluates a project from the source code read from the given project file. Der Quellcode wird mit den globalen Eigenschaften dieser Projektauflistung und der angegebenen Toolsversion ausgewertet.The source code is evaluated with the global properties of this project collection and the given tools version.

LoadProject(XmlReader) LoadProject(XmlReader) LoadProject(XmlReader) LoadProject(XmlReader)

Wertet ein Projekt anhand des vom angegebenen XML-Reader gelesenen Quellcodes aus.Evaluates a project from the source code read from the given XML reader. Der Quellcode wird mit den globalen Eigenschaften und der Toolsversion dieser Projektauflistung ausgewertet.The source code is evaluated with the global properties and tools version of this project collection.

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

Wertet ein Projekt anhand des vom angegebenen XML-Reader gelesenen Quellcodes aus.Evaluates a project from the source code read from the given XML reader. Der Quellcode wird mit den angegebenen globalen Eigenschaften und der Toolsversion ausgewertet.The source code is evaluated with the given global properties and tools version.

LoadProject(XmlReader, String) LoadProject(XmlReader, String) LoadProject(XmlReader, String) LoadProject(XmlReader, String)

Wertet ein Projekt anhand des vom angegebenen XML-Reader gelesenen Quellcodes aus.Evaluates a project from the source code read from the given XML reader. Der Quellcode wird mit den globalen Eigenschaften dieser Projektauflistung und der angegebenen Toolsversion ausgewertet.The source code is evaluated with the global properties of this project collection and the given tools version.

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

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

(Inherited from Object)
RegisterForwardingLoggers(IEnumerable<ForwardingLoggerRecord>) RegisterForwardingLoggers(IEnumerable<ForwardingLoggerRecord>) RegisterForwardingLoggers(IEnumerable<ForwardingLoggerRecord>) RegisterForwardingLoggers(IEnumerable<ForwardingLoggerRecord>)

Fügt die angegebenen Remoteprotokollierungen zur Auflistung von Remoteprotokollierungen hinzu, die in dieser Auflistung für Builds von Projekten verwendet wurden.Adds the given remote loggers to the collection of remote loggers used for builds of projects in this collection.

RegisterLogger(ILogger) RegisterLogger(ILogger) RegisterLogger(ILogger) RegisterLogger(ILogger)

Fügt die angegebene Protokollierung zur Auflistung von Protokollierungen hinzu, die in dieser Auflistung für Builds von Projekten verwendet wurden.Adds the given logger to the collection of loggers used for builds of projects in this collection.

RegisterLoggers(IEnumerable<ILogger>) RegisterLoggers(IEnumerable<ILogger>) RegisterLoggers(IEnumerable<ILogger>) RegisterLoggers(IEnumerable<ILogger>)

Fügt die angegebenen Protokollierungen zur Auflistung von Protokollierungen hinzu, die in dieser Auflistung für Builds von Projekten verwendet wurden.Adds the given loggers to the collection of loggers used for builds of projects in this collection.

RemoveAllToolsets() RemoveAllToolsets() RemoveAllToolsets() RemoveAllToolsets()

Entfernt alle Toolsets aus der Projektauflistung.Removes all toolsets from the project collection.

RemoveGlobalProperty(String) RemoveGlobalProperty(String) RemoveGlobalProperty(String) RemoveGlobalProperty(String)

Entfernt eine globale Eigenschaft aus dem Satz von globalen Standardeigenschaften.Removes a global property from the set of default global properties.

RemoveToolset(String) RemoveToolset(String) RemoveToolset(String) RemoveToolset(String)

Entfernt ein Toolset aus der Projektauflistung.Removes a toolset from the project collection.

SetGlobalProperty(String, String) SetGlobalProperty(String, String) SetGlobalProperty(String, String) SetGlobalProperty(String, String)

Legt den Wert einer Eigenschaft im Standardsatz globaler Eigenschaften fest.Sets the value of a property in the default set of global properties.

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)
TryUnloadProject(ProjectRootElement) TryUnloadProject(ProjectRootElement) TryUnloadProject(ProjectRootElement) TryUnloadProject(ProjectRootElement)

Versucht, ein Projekt aus der Auflistung zu entfernen.Attempts to remove a project from the collection.

Unescape(String) Unescape(String) Unescape(String) Unescape(String)

Konvertiert Escapezeichen in einer Zeichenfolge in MSBuild-Zeichen mit besonderer Bedeutung.Converts escaped characters in a string to MSBuild characters with special meaning.

UnloadAllProjects() UnloadAllProjects() UnloadAllProjects() UnloadAllProjects()

Entfernt alle Projekte in dieser Projektauflistung.Removes all projects in this project collection.

UnloadProject(Project) UnloadProject(Project) UnloadProject(Project) UnloadProject(Project)

Entfernt das angegebene Projekt aus der Projektauflistung.Removes the given project from the project collection.

UnloadProject(ProjectRootElement) UnloadProject(ProjectRootElement) UnloadProject(ProjectRootElement) UnloadProject(ProjectRootElement)

Entfernt ein Projektstammelement aus dem Projektstammcache.Removes a project root element from the project root cache.

UnregisterAllLoggers() UnregisterAllLoggers() UnregisterAllLoggers() UnregisterAllLoggers()

Entfernt alle Protokollierungen aus der Auflistung von Protokollierungen, die von Projektbuilds in dieser Auflistung verwendet wurden.Removes all loggers from the collection of loggers used by project builds in this collection.

Ereignisse

ProjectAdded ProjectAdded ProjectAdded ProjectAdded

Ereignis, das ausgelöst wird, wenn ein Projekt für ProjectRootElementCache dieser Projektsammlung hinzugefügt wird.Event that is fired when a project is added to the ProjectRootElementCache of this project collection.

ProjectChanged ProjectChanged ProjectChanged ProjectChanged

Wird ausgelöst, wenn ein Project, das in dieser Instanz enthalten ist, direkt geändert wird.Raised when a Project contained by this instance is directly changed.

ProjectCollectionChanged ProjectCollectionChanged ProjectCollectionChanged ProjectCollectionChanged

Wird ausgelöst, wenn der Zustand dieser Instanz geändert wird.Raised when state is changed on this instance.

ProjectXmlChanged ProjectXmlChanged ProjectXmlChanged ProjectXmlChanged

Wird ausgelöst, wenn ein ProjectRootElement, die in dieser Instanz enthalten ist, geändert wird.Raised when a ProjectRootElement contained by this instance is changed.

Gilt für: