Microsoft.Build.Framework Obor názvů

Obsahuje typy, které definují, jak úlohy a protokolovací nástroje komunikují s modulem MSBuild. Contains the types that define how tasks and loggers interact with the MSBuild engine. Informace naleznete v tématu MSBuild. For information, see MSBuild.

Třídy

BuildErrorEventArgs

Argumenty pro chybové událostiArguments for error events

BuildEventArgs

Tato třída zapouzdřuje výchozí data přidružená k událostem sestavení.This class encapsulates the default data associated with build events. Je určena pro rozšířené/podtřídy.It is intended to be extended/sub-classed.

BuildEventContext

Poskytne informace o poloze pro událost, což je zvlášť potřeba v prostředí s více procesory.Will provide location information for an event, this is especially needed in a multi processor environment

BuildFinishedEventArgs

Tato třída reprezentuje argumenty události pro události dokončení sestavení.This class represents the event arguments for build finished events.

BuildMessageEventArgs

Argumenty pro události zprávArguments for message events

BuildStartedEventArgs

Argumenty pro události sestavení zahájeny.Arguments for build started events.

BuildStatusEventArgs

Základní třída pro události stavu sestaveníBase class for build status events. Tato třída je určena k rozšíření.This class is meant to be extended.

BuildWarningEventArgs

Argumenty pro události upozorněníArguments for warning events

CriticalBuildMessageEventArgs

Argumenty pro kritické události zpráv.Arguments for critical message events. Tyto vždycky mají vysokou důležitost.These always have High importance.

CustomBuildEventArgs

Argumenty pro vlastní události sestavení.Arguments for custom build events.

EnvironmentVariableReadEventArgs

Argumenty události čtení proměnné prostředíArguments for the environment variable read event.

ExternalProjectFinishedEventArgs

Argumenty pro události dokončených externích projektůArguments for external project finished events

ExternalProjectStartedEventArgs

Argumenty pro události spouštěné v externích projektechArguments for external project started events

LazyFormattedBuildEventArgs

Ukládá řetězce pro části zprávy o zpoždění formátování, dokud není nutné zobrazení.Stores strings for parts of a message delaying the formatting until it needs to be shown

LoadInSeparateAppDomainAttribute

Tento atribut slouží k označení úloh, které je třeba spustit ve svých vlastních doménách aplikace.This attribute is used to mark tasks that need to be run in their own app domains. Modul Build vytvoří novou doménu aplikace pokaždé, když ji potřebuje ke spuštění takové úlohy, a okamžitě ji po dokončení úkolu uvolní.The build engine will create a new app domain each time it needs to run such a task, and immediately unload it when the task is finished.

LoggerException

Výjimka, která by měla být vyvolána protokolovacím nástrojem, když nemůže pokračovat.Exception that should be thrown by a logger when it cannot continue. Umožňuje protokolovacímu nástroje vynucené zastavení sestavení explicitním způsobem, kdy například obdrží neplatné parametry nebo nemůže zapisovat na disk.Allows a logger to force the build to stop in an explicit way, when, for example, it receives invalid parameters, or cannot write to disk.

MetaprojectGeneratedEventArgs

Argumenty pro událost vygenerovanou metaprojectArguments for the metaproject generated event.

OutputAttribute

Tento atribut používají zapisovače úloh k označení určitých parametrů úlohy jako "výstupy".This attribute is used by task writers to designate certain task parameters as "outputs". Modul sestavení bude umožňovat pouze parametry úloh (tj. vlastnosti rozhraní .NET třídy Task), které jsou označeny tímto atributem pro výstup dat z úlohy.The build engine will only allow task parameters (i.e. the task class' .NET properties) that are marked with this attribute to output data from a task. Autoři projektu mohou použít pouze parametry označené tímto atributem v rámci < výstupní značky úkolu > .Project authors can only use parameters marked with this attribute in a task's <Output> tag. Všechny parametry úlohy, včetně těch, které jsou označeny tímto atributem, mohou být zpracovány jako vstupy pro úlohu modulem sestavení.All task parameters, including those marked with this attribute, may be treated as inputs to a task by the build engine.

ProjectEvaluationFinishedEventArgs

Argumenty události dokončeného vyhodnocení projektu.Arguments for the project evaluation finished event.

ProjectEvaluationStartedEventArgs

Argumenty pro událost spuštění vyhodnocení projektu.Arguments for the project evaluation started event.

ProjectFinishedEventArgs

Argumenty pro události dokončených projektůArguments for project finished events

ProjectImportedEventArgs

Argumenty události importovaného projektuArguments for the project imported event.

ProjectStartedEventArgs

Argumenty pro události spouštěné v projektuArguments for project started events

PropertyInitialValueSetEventArgs

Argument pro událost počáteční hodnoty vlastnosti.The argument for a property initial value set event.

PropertyReassignmentEventArgs

Argument události opětovného přiřazení vlastnosti.The argument for a property reassignment event.

RequiredAttribute

Tato třída definuje atribut, který může zapisovač úloh použít na vlastnost úkolu k deklaraci vlastnosti jako požadované vlastnosti.This class defines the attribute that a task writer can apply to a task's property to declare the property to be a required property.

RequiredRuntimeAttribute

Když je označena jako RequiredRuntimeAttribute, úloha indikuje, že má přísnější požadavky na modul runtime než běžný úkol – to oznamuje nástroji MSBuild, že bude muset spustit samostatný proces pro tuto úlohu, pokud aktuální modul runtime neodpovídá požadavku na verzi.When marked with the RequiredRuntimeAttribute, a task indicates that it has stricter runtime requirements than a regular task - this tells MSBuild that it will need to potentially launch a separate process for that task if the current runtime does not match the version requirement. Tento atribut není v současnosti funkční, protože existuje pouze jedna verze modulu CLR, která je schopna spustit nástroj MSBuild v 2.0 nebo v 3.5 – modul runtime v 2.0This attribute is currently non-functional since there is only one version of the CLR that is capable of running MSBuild v2.0 or v3.5 - the runtime v2.0

RunInMTAAttribute

Tento atribut slouží k označení třídy úlohy tak, aby se explicitně nevyžadovaly spuštění v STA pro COM.This attribute is used to mark a task class as explicitly not being required to run in the STA for COM.

RunInSTAAttribute

Tento atribut slouží k označení třídy úlohy, která je vyžadována pro spuštění v jednom vlákně s vláknem pro model COM.This attribute is used to mark a task class as being required to run in a Single Threaded Apartment for COM.

SdkLogger

Abstraktní třída rozhraní pro poskytování protokolování a stavu v reálném čase při řešení sady SDK.An abstract interface class to providing real-time logging and status while resolving an SDK.

SdkReference

Představuje sadu SDK (Software Development Kit), na kterou odkazuje < projekt/ > nebo < Import/ > element.Represents a software development kit (SDK) that is referenced in a <Project /> or <Import /> element.

SdkResolver

Abstraktní rozhraní pro třídy, které mohou vyřešit sadu SDK (Software Development Kit).An abstract interface for classes that can resolve a Software Development Kit (SDK).

SdkResolverContext

Kontext používaný při SdkResolver řešení sady SDK.Context used by an SdkResolver to resolve an SDK.

SdkResult

Abstraktní třída rozhraní, která označuje úspěch nebo neúspěch překladače sady SDK.An abstract interface class to indicate SDK resolver success or failure. Poznámka: použijte SdkResultFactory k vytvoření instancí této třídy.Note: Use SdkResultFactory to create instances of this class. Nedědit z této třídy.Do not inherit from this class.

SdkResultFactory

Abstraktní třída rozhraní poskytnutá k SdkResolver vytvoření SdkResult objektu indikující úspěch nebo selhání.An abstract interface class provided to SdkResolver to create an SdkResult object indicating success / failure.

SdkResultItem

Hodnota položky a všechna přidružená metadata, která mají být přidána překladačem sady SDK.The value of an item and any associated metadata to be added by an SDK resolver. Viz také ItemsToAdd .Also see ItemsToAdd.

TargetFinishedEventArgs

Argumenty pro události cíle pro dokončeníArguments for target finished events

TargetSkippedEventArgs

Argumenty pro událost cíle byla vynechána.Arguments for the target skipped event.

TargetStartedEventArgs

Argumenty pro události v cíli byly zahájeny.Arguments for target started events

TaskCommandLineEventArgs

Tato třída je používána úlohami k protokolování jejich příkazových řádků.This class is used by tasks to log their command lines. Tato třída rozšiřuje BuildMessageEventArgs , takže příkazové řádky mohou být protokolovány jako zprávy.This class extends BuildMessageEventArgs so that command lines can be logged as messages. Protokolování příkazového řádku je relevantní jenom pro úlohy, které zabalí základní spustitelný soubor nebo nástroj, nebo emuluje příkaz prostředí.Logging a command line is only relevant for tasks that wrap an underlying executable/tool, or emulate a shell command. Úlohy, které nemají žádný ekvivalent na příkazovém řádku, by neměly tuto rozšířenou událost zprávy vyvolat.Tasks that have no command line equivalent should not raise this extended message event.

TaskFinishedEventArgs

Argumenty pro události dokončených úlohArguments for task finished events

TaskPropertyInfo

Třída, která představuje informace o parametrech z úlohy using jako třída se silným typem.Class which represents the parameter information from the using task as a strongly typed class.

TaskStartedEventArgs

Argumenty pro události spuštění úlohyArguments for task started events

TelemetryEventArgs

Argumenty pro události telemetrieArguments for telemetry events.

UninitializedPropertyReadEventArgs

Argumenty události čtení neinicializované vlastnosti.The arguments for an uninitialized property read event.

Struktury

BuildEngineResult

Tato struktura slouží k vrácení výsledku sestavení a výstupů cíle.This structure is used to return the result of the build and the target outputs.

Rozhraní

IBuildEngine

Toto rozhraní zpřístupňuje funkce v modulu sestavení, který je požadován pro vytváření úloh.This interface exposes functionality on the build engine that is required for task authoring.

IBuildEngine2

Toto rozhraní rozšiřuje IBuildEngine tak, aby poskytovalo metodu umožňující paralelní sestavení souborů projektu.This interface extends IBuildEngine to provide a method allowing building project files in parallel.

IBuildEngine3

Toto rozhraní rozšiřuje IBuildEngine tak, aby poskytovalo metodu umožňující paralelní sestavení souborů projektu.This interface extends IBuildEngine to provide a method allowing building project files in parallel.

IBuildEngine4

Toto rozhraní rozšiřuje IBuildEngine a poskytuje mechanismus, který umožňuje úlohám sdílet data mezi voláními úloh.This interface extends IBuildEngine to provide a mechanism allowing tasks to share data between task invocations.

IBuildEngine5

Toto rozhraní rozšiřuje IBuildEngine na telemetrii protokolu.This interface extends IBuildEngine to log telemetry.

IBuildEngine6

Toto rozhraní rozšiřuje IBuildEngine5 a povoluje úlohám získat globální vlastnosti aktuálního projektu.This interface extends IBuildEngine5 to allow tasks to get the current project's global properties.

IBuildEngine7

Toto rozhraní rozšiřuje IBuildEngine6 , aby bylo možné úlohy nastavit, zda mají být při návratu úlohy bez protokolování chyby zaznamenávány chyby.This interface extends IBuildEngine6 to allow tasks to set whether they want to log an error when a task returns without logging an error.

ICancelableTask

Rozhraní pro úlohy, které lze zrušit.Interface for tasks which can be cancelled.

IEventRedirector

Toto rozhraní se používá pro přeposílání událostí do jiných protokolovacích nástrojů.This interface is used to forward events to another loggers

IEventSource

Toto rozhraní definuje události vyvolané modulem sestavení.This interface defines the events raised by the build engine. Protokolovací nástroje používají toto rozhraní k přihlášení k odběru událostí, které mají zájem o přijetí.Loggers use this interface to subscribe to the events they are interested in receiving.

IEventSource2

Toto rozhraní definuje události vyvolané modulem sestavení.This interface defines the events raised by the build engine. Protokolovací nástroje používají toto rozhraní k přihlášení k odběru událostí, které mají zájem o přijetí.Loggers use this interface to subscribe to the events they are interested in receiving.

IEventSource3

Toto rozhraní definuje události vyvolané modulem sestavení.This interface defines the events raised by the build engine. Protokolovací nástroje používají toto rozhraní k přihlášení k odběru událostí, které mají zájem o přijetí.Loggers use this interface to subscribe to the events they are interested in receiving.

IForwardingLogger

Toto rozhraní rozšiřuje rozhraní ILogger, aby poskytovalo vlastnost, která se dá použít k přeposílání událostí do protokolovacího nástroje spuštěného v jiném procesu.This interface extends the ILogger interface to provide a property which can be used to forward events to a logger running in a different process. Dá se použít i k vytvoření protokolovacích protokolovacích nástrojů.It can also be used create filtering loggers.

IGeneratedTask

Rozhraní implementované úlohami, které jsou generovány instancemi ITaskFactory.An interface implemented by tasks that are generated by ITaskFactory instances.

ILogger

Toto rozhraní definuje v systému sestavení "protokolovací nástroj".This interface defines a "logger" in the build system. Protokolovací nástroj vytváří odběr systémových událostí.A logger subscribes to build system events. Všechny třídy protokolovacího nástroje musí implementovat toto rozhraní, aby ho modul sestavení rozpoznal.All logger classes must implement this interface to be recognized by the build engine.

INodeLogger

Toto rozhraní definuje "souběžně pracující protokolovací nástroj" v systému sestavení.This interface defines a "parallel aware logger" in the build system. Protokolovací nástroj s podporou paralelního zpracování bude akceptovat počet procesorů a počítejte s tím, že počet procesorů větší než 1 znamená, že se události z protokolovacího nástroje od každého procesoru přijímají do protokolu událostí.A parallel aware logger will accept a cpu count and be aware that any cpu count greater than 1 means the events will be received from the logger from each cpu as the events are logged.

IProjectElement

Rozhraní pro vystavení ProjectElement odpovídajícím protokolovacím nástrojůmInterface for exposing a ProjectElement to the appropriate loggers

ITask

Toto rozhraní definuje "úlohu" v systému sestavení.This interface defines a "task" in the build system. Úkol je atomická jednotka operace sestavení.A task is an atomic unit of build operation. Všechny třídy úloh musí implementovat toto rozhraní, aby ho modul sestavení rozpoznal.All task classes must implement this interface to be recognized by the build engine.

ITaskFactory

Rozhraní, které by měla implementovat instance objektu pro vytváření úlohInterface that a task factory Instance should implement

ITaskFactory2

Rozhraní, které instance objektu pro vytváření úloh by měla implementovat, pokud chce používat nové parametry UsingTask, jako je například modul runtime a architektura.Interface that a task factory Instance should implement if it wants to be able to use new UsingTask parameters such as Runtime and Architecture.

ITaskHost

Toto prázdné rozhraní se používá k předání objektů hostitele z integrovaného vývojového prostředí do jednotlivých úloh.This empty interface is used to pass host objects from an IDE to individual tasks. V závislosti na samotné úloze a jakém druhu a funkcích, které zpřístupňuje, by měl úkol definovat vlastní rozhraní, které dědí z tohoto typu, a potom použít toto rozhraní ke komunikaci s hostitelem.Depending on the task itself and what kinds parameters and functionality it exposes, the task should define its own interface that inherits from this one, and then use that interface to communicate with the host.

ITaskItem

Toto rozhraní definuje položku projektu, kterou lze spotřebovat a emitovat úkoly.This interface defines a project item that can be consumed and emitted by tasks.

ITaskItem2

Toto rozhraní přidává do rozhraní ITaskItem podporu uvozovacích znaků.This interface adds escaping support to the ITaskItem interface.

Výčty

LoggerVerbosity

Výčet úrovní podrobností protokolu událostí.Enumeration of the levels of detail of an event log.

MessageImportance

Tento výčet poskytuje pro zprávy tři úrovně důležitosti.This enumeration provides three levels of importance for messages.

RegisteredTaskObjectLifetime

Definuje životnost objektu registrované úlohy.Defines the lifetime of a registered task object.

TargetBuiltReason

Důvod, proč byl cíl vytvořen svým nadřazeným cílem.The reason that a target was built by its parent target.

Delegáti

AnyEventHandler

Typ obslužné rutiny pro události AnyEventRaisedType of handler for AnyEventRaised events

BuildErrorEventHandler

Typ obslužné rutiny pro události ErrorRaisedType of handler for ErrorRaised events

BuildFinishedEventHandler

Typ obslužné rutiny pro události BuildFinishedEventType of handler for BuildFinishedEvent events

BuildMessageEventHandler

Typ obslužné rutiny pro události MessageRaisedType of handler for MessageRaised events

BuildStartedEventHandler

Typ obslužné rutiny pro události BuildStartedEventType of handler for BuildStartedEvent events

BuildStatusEventHandler

Typ obslužné rutiny pro události BuildStatusType of handler for BuildStatus events

BuildWarningEventHandler

Typ obslužné rutiny pro události WarningRaisedType of handler for WarningRaised events

CustomBuildEventHandler

Typ obslužné rutiny pro události CustomEventRaisedType of handler for CustomEventRaised events

ProjectFinishedEventHandler

Typ obslužné rutiny pro události ProjectFinishedType of handler for ProjectFinished events

ProjectStartedEventHandler

Typ obslužné rutiny pro události ProjectStartedType of handler for ProjectStarted events

TargetFinishedEventHandler

Typ obslužné rutiny pro události TargetFinishedType of handler for TargetFinished events

TargetStartedEventHandler

Typ obslužné rutiny pro události TargetStartedType of handler for TargetStarted events

TaskFinishedEventHandler

Typ obslužné rutiny pro události TaskFinishedType of handler for TaskFinished events

TaskStartedEventHandler

Typ obslužné rutiny pro události TaskStartedType of handler for TaskStarted events

TelemetryEventHandler

Typ obslužné rutiny pro události TelemetryLoggedType of handler for TelemetryLogged events