ProjectCollection Classe

Definizione

Incapsula un set di progetti correlati, i relativi set di strumenti, un set predefinito di proprietà globali e i logger da utilizzare per compilarli.Encapsulates a set of related projects, their toolsets, a default set of global properties, and the loggers that should be used to build them. Una versione globale di questa classe funge da insieme di progetti predefinito.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
Ereditarietà
ProjectCollection
Implementazioni

Commenti

All'interno di un dominio dell'applicazione possono esistere più raccolte di progetti.Multiple project collections can exist within an app domain. Tuttavia, questi non devono essere compilati contemporaneamente.However, these must not build concurrently.

Costruttori

ProjectCollection()

Crea un insieme di progetti senza proprietà globali o logger.Creates a project collection with no global properties or loggers. Il set di strumenti dell'insieme di progetti viene inizializzato dal file di configurazione e dal Registro di sistema.The project collection toolset is initialized from the configuration file and registry.

ProjectCollection(IDictionary<String,String>)

Crea un'istanza di un insieme di progetti con proprietà globali specificate, senza logger e in grado di leggere informazioni sul set di strumenti dal file di configurazione e dal Registro di sistema.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)

Crea un insieme di progetti con le proprietà globali, i logger, il conteggio dei nodi e il valore onlyLogCriticalEvents specificati.Creates a project collection with specified global properties, loggers, node count, and onlyLogCriticalEvents value. Il set di strumenti dell'insieme di progetti viene inizializzato dai set di strumenti nei percorsi specificati.The project collection toolset is initialized from toolsets in the given locations.

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

Crea un'istanza di un insieme di progetti con proprietà globali e logger specificati e utilizzando i percorsi dei set di strumenti specificati.Instantiates a project collection with specified global properties and loggers and using the specified toolset locations.

ProjectCollection(ToolsetDefinitionLocations)

Crea un insieme di progetti senza proprietà globali o logger.Creates a project collection with no global properties or loggers. Il set di strumenti dell'insieme di progetti viene inizializzato dai set di strumenti nei percorsi specificati.The project collection toolset is initialized from toolsets in the given locations.

Proprietà

Count

Ottiene il numero di progetti attualmente caricati nella raccolta.Gets the number of projects currently loaded into this collection.

DefaultToolsVersion

Ottiene la versione degli strumenti predefinita dell'insieme di progetti.Gets the default tools version of this project collection.

DisableMarkDirty

Ottiene o imposta un flag che determina se MarkDirty() è temporaneamente disabilitato sui progetti dell'insieme.Gets or sets a flag that determines whether MarkDirty() is temporarily disabled on projects in this collection. In questo modo è possibile, ad esempio, impostare proprietà globali senza che i progetti di conseguenza vengano contrassegnati come modificati per la rivalutazione.This allows, for example, a global properties to be set without projects getting marked dirty for reevaluation as a consequence.

GlobalProjectCollection

Ottiene l'oggetto insieme di progetti globale.Gets the global project collection object.

GlobalProperties

Ottiene le proprietà globali predefinite di sola lettura per tutti i progetti dell'insieme.Gets the read-only default global properties for all projects in this collection.

HostServices

Ottiene o imposta un oggetto che fornisce servizi host alle attività durante le compilazioni di progetti contenuti nell'insieme di progetti.Gets or sets an object that provides host services to tasks during builds of projects contained in the project collection.

IsBuildEnabled

Ottiene o imposta un valore che indica se le destinazioni e le attività dei progetti nella raccolta di progetti possono essere compilate.Gets or sets a value that indicates whether the targets and tasks of projects in the project collection can be built.

LoadedProjects

Ottiene tutti i progetti attualmente caricati nell'insieme.Gets all the projects currently loaded into this collection.

Loggers

Ottiene tutti i logger che possono essere utilizzati dai progetti dell'insieme per le compilazioni.Gets all loggers that projects in this collection can use for their builds.

OnlyLogCriticalEvents

Ottiene o imposta un valore che indica se vengono registrati solo gli eventi critici, ad esempio avvisi ed errori.Gets or sets a value that indicates whether only critical events such as warnings and errors are logged.

SkipEvaluation

Ottiene o imposta un valore che indica se ReevaluateIfNecessary è temporaneamente disabilitato nei progetti della raccolta.Gets or sets a value the indicates whether ReevaluateIfNecessary is temporarily disabled on projects in this collection. È utile quando l'host prevede di eseguire un numero di letture e scritture nei progetti ed è preferibile sacrificare temporaneamente la correttezza per migliorare le prestazioni.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

Ottiene i percorsi utilizzati per trovare i set di strumenti.Gets the locations used to find the toolsets.

Toolsets

Ottiene i set di strumenti disponibili per l'insieme di progetti.Gets the toolsets available to this project collection.

Version

Ottiene la versione del file di assembly contenente il motore MSBuild.Gets the file version of the assembly file that contains the MSBuild engine.

Metodi

AddToolset(Toolset)

Aggiunge un nuovo set di strumenti all'insieme di progetti.Adds a new toolset to the project collection. Sostituisce qualsiasi set di strumenti esistente con la stessa versione degli strumenti.Replaces any existing toolset with the same tools version.

ContainsToolset(String)

Determina se viene definito un set di strumenti per la versione degli strumenti specificata.Determines whether a toolset is defined for the given tools version.

Dispose()

Rilascia le risorse gestite e non gestite.Releases both managed and unmanaged resources. Chiamato quando a un host non serve più l'insieme di progetti.Called when a host no longer needs the project collection.

Dispose(Boolean)

Rilascia le risorse gestite e non gestite.Releases both managed and unmanaged resources. Chiamato quando a un host non serve più l'insieme di progetti.Called when a host no longer needs the project collection. Arresta eventuali servizi di registrazione di proprietà dell'insieme di progetti e rilascia il thread del logger.Shuts down any logging services that the project collection owns and releases the logger thread.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
Escape(String)

Converte i caratteri speciali in una stringa in formato di escape di MSBuild.Converts special characters in a string to MSBuild escape format.

GetGlobalProperty(String)

Ottiene qualsiasi proprietà globale nella raccolta di progetti con il nome specificato.Gets any global property on the project collection that has the specified name.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetLoadedProjects(String)

Ottiene tutti i progetti il cui percorso corrisponde al percorso specificato.Gets all projects whose project path matches the given path.

GetToolset(String)

Ottiene il set di strumenti con la versione degli strumenti specificata.Gets the toolset with the specified tools version.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
LoadProject(String)

Valuta un progetto dal codice sorgente nel file di progetto specificato.Evaluates a project from the source code in the given project file. Il codice sorgente viene valutato con le proprietà globali e la versione degli strumenti dell'insieme di progetti.The source code is evaluated with the global properties and tools version of this project collection.

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

Valuta un progetto dal codice sorgente letto dal file di progetto specificato.Evaluates a project from the source code read from the given project file. Il codice sorgente viene valutato con le proprietà globali e la versione degli strumenti specificate.The source code is evaluated with the given global properties and tools version.

LoadProject(String, String)

Valuta un progetto dal codice sorgente letto dal file di progetto specificato.Evaluates a project from the source code read from the given project file. Il codice sorgente viene valutato con le proprietà globali dell'insieme di progetti e la versione degli strumenti specificata.The source code is evaluated with the global properties of this project collection and the given tools version.

LoadProject(XmlReader)

Valuta un progetto dal codice sorgente letto dal lettore XML specificato.Evaluates a project from the source code read from the given XML reader. Il codice sorgente viene valutato con le proprietà globali e la versione degli strumenti dell'insieme di progetti.The source code is evaluated with the global properties and tools version of this project collection.

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

Valuta un progetto dal codice sorgente letto dal lettore XML specificato.Evaluates a project from the source code read from the given XML reader. Il codice sorgente viene valutato con le proprietà globali e la versione degli strumenti specificate.The source code is evaluated with the given global properties and tools version.

LoadProject(XmlReader, String)

Valuta un progetto dal codice sorgente letto dal lettore XML specificato.Evaluates a project from the source code read from the given XML reader. Il codice sorgente viene valutato con le proprietà globali dell'insieme di progetti e la versione degli strumenti specificata.The source code is evaluated with the global properties of this project collection and the given tools version.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
RegisterForwardingLoggers(IEnumerable<ForwardingLoggerRecord>)

Aggiunge i logger remoti specificati all'insieme di logger remoti utilizzato per le compilazioni di progetti nell'insieme.Adds the given remote loggers to the collection of remote loggers used for builds of projects in this collection.

RegisterLogger(ILogger)

Aggiunge i logger specificati all'insieme di logger utilizzati per le compilazioni di progetti nell'insieme.Adds the given logger to the collection of loggers used for builds of projects in this collection.

RegisterLoggers(IEnumerable<ILogger>)

Aggiunge i logger specificati all'insieme di logger utilizzati per le compilazioni di progetti nell'insieme.Adds the given loggers to the collection of loggers used for builds of projects in this collection.

RemoveAllToolsets()

Rimuove tutti i set di strumenti dall'insieme di progetti.Removes all toolsets from the project collection.

RemoveGlobalProperty(String)

Rimuove una proprietà globale dal set di proprietà globali predefinite.Removes a global property from the set of default global properties.

RemoveToolset(String)

Rimuove un set di strumenti dall'insieme di progetti.Removes a toolset from the project collection.

SetGlobalProperty(String, String)

Imposta il valore di una proprietà nel set predefinito di proprietà globali.Sets the value of a property in the default set of global properties.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
TryUnloadProject(ProjectRootElement)

Tenta di rimuovere un progetto dall'insieme.Attempts to remove a project from the collection.

Unescape(String)

Converte i caratteri di escape in una stringa nei caratteri di MSBuild con significato speciale.Converts escaped characters in a string to MSBuild characters with special meaning.

UnloadAllProjects()

Rimuove tutti i progetti dell'insieme di progetti.Removes all projects in this project collection.

UnloadProject(Project)

Rimuove il progetto specificato dall'insieme di progetti.Removes the given project from the project collection.

UnloadProject(ProjectRootElement)

Rimuove un elemento radice del progetto dalla cache radice del progetto.Removes a project root element from the project root cache.

UnregisterAllLoggers()

Rimuove tutti i logger dall'insieme di logger utilizzati dalle compilazioni di progetti nell'insieme.Removes all loggers from the collection of loggers used by project builds in this collection.

Eventi

ProjectAdded

Evento generato quando un progetto viene aggiunto all'elemento ProjectRootElementCache di questa raccolta di progetti.Event that is fired when a project is added to the ProjectRootElementCache of this project collection.

ProjectChanged

Generato quando viene modificato direttamente l'oggetto Project contenuto da questa istanza.Raised when a Project contained by this instance is directly changed.

ProjectCollectionChanged

Generato quando lo stato viene modificato in questa istanza.Raised when state is changed on this instance.

ProjectXmlChanged

Generato quando viene modificato l'oggetto ProjectRootElement contenuto da questa istanza.Raised when a ProjectRootElement contained by this instance is changed.

Si applica a