LC-Aufgabe

  • Artikel

Umschließt LC.exe, wodurch eine LICENSE-Datei aus einer LICX-Datei generiert wird. Weitere Informationen zu LC.exe finden Sie unter LC.exe (Lizenzcompiler).

Parameter

In der folgenden Tabelle werden die Parameter für die LC-Aufgabe beschrieben.

Parameter Beschreibung
LicenseTarget Erforderlicher ITaskItem -Parameter.

Gibt die ausführbare Datei an, für die die LICENSES-Dateien generiert werden.
NoLogo Optionaler Boolean-Parameter.

Unterdrückt die Anzeige des Startbanners von Microsoft.
OutputDirectory Optionaler String-Parameter.

Gibt das Verzeichnis an, in dem die LICENSES-Ausgabedateien gespeichert werden sollen.
OutputLicense Optionaler ITaskItem-Ausgabeparameter.

Gibt den Namen der LICENSES-Datei an. Wenn Sie keinen Namen angeben, wird der Name der LICX-Datei verwendet, und die LICENSES-Datei wird in dem Verzeichnis gespeichert, das die LICX-Datei enthält.
ReferencedAssemblies Optionaler ITaskItem[]-Parameter

Gibt die referenzierten Komponenten an, die beim Generieren der LICENSE-Datei geladen werden sollen.
SdkToolsPath Optionaler String-Parameter.

Legt den Pfad zu den SDK-Tools fest, wie z.B. resgen.exe.
Sources Erforderlicher ITaskItem[]-Parameter.

Gibt die Elemente mit lizenzierten Komponenten an, die in die LICENSES-Datei aufgenommen werden sollen. Weitere Informationen finden Sie in der Dokumentation zum /complist-Schalter in Lc.exe (License Compiler) (Lc.exe [Lizenzcompiler]).

ToolTaskExtension-Parameter

Dieser Task erbt aus der ToolTaskExtension-Klasse, die aus der ToolTask-Klasse erbt, welche wiederum aus der Task-Klasse erbt. Diese Vererbungskette fügt verschiedene Parameter zu den Aufgaben hinzu, die aus ihnen abgeleitet werden.

In der folgenden Tabelle werden die Parameter der Basisklassen beschrieben:

Parameter Beschreibung
EchoOff Optionaler bool-Parameter.

Bei der Festlegung auf true gibt diese Aufgabe /Q an die Befehlszeile cmd.exe so weiter, dass die Befehlszeile nicht zu „stdout“ kopiert wird.
EnvironmentVariables Optionaler String-Arrayparameter.

Array aus Umgebungsvariablendefinitionen, getrennt durch Semikolons. Jede Definition sollte einen Namen und einen Wert für eine Umgebungsvariable angeben, getrennt durch ein Gleichheitszeichen. Diese Variablen werden an die erstellte ausführbare Datei zusätzlich zum regulären Umgebungsblock oder zum ausgewählten Überschreiben hinzugefügt. Beispiel: Variable1=Value1;Variable2=Value2.
ExitCode Optionaler schreibgeschützter Int32-Ausgabeparameter.

Gibt den durch den ausgeführten Befehl bereitgestellten Exitcode an. Wenn bei der Aufgabe Fehler protokolliert wurden, der Prozess jedoch über einen Exitcode von „0“ (Erfolg) verfügt hat, wird dies auf „-1“ festgelegt.
LogStandardErrorAsError Optionaler bool-Parameter.

Wenn true gegeben ist, werden alle im Standardfehlerstream empfangenen Meldungen als Fehler protokolliert.
StandardErrorImportance Optionaler String-Parameter.

Wichtigkeit, mit der Text aus dem Standardfehlerstream protokolliert wird.
StandardOutputImportance Optionaler String-Parameter.

Wichtigkeit, mit der Text aus dem Standardausgabestream protokolliert wird.
Timeout Optionaler Int32-Parameter.

Gibt die Zeitdauer in Millisekunden an, nach der die ausführbare Datei der Aufgabe beendet wird. Der Standardwert ist Int.MaxValue. Dieser gibt an, dass es kein Zeitlimit gibt. Das Timeout in Millisekunden.
ToolExe Optionaler string-Parameter.

Projekte implementieren dies möglicherweise zum Überschreiben eines ToolName. Aufgaben überschreiben dies möglicherweise zum Beibehalten des ToolName.
ToolPath Optionaler string-Parameter.

Gibt den Speicherort an, von wo aus die Aufgabe die zugrunde liegende ausführbare Datei lädt. Wenn dieser Parameter nicht angegeben ist, verwendet die Aufgabe den SDK-Installationspfad der Version des Frameworks, die von MSBuild ausgeführt wird.
UseCommandProcessor Optionaler bool-Parameter.

Wenn die Festlegung auf true gegeben ist, erstellt diese Aufgabe eine Batchdatei für die Befehlszeile und führt sie aus, indem der Befehl nicht direkt ausgeführt wird, sondern der Befehlsprozessor verwendet wird.
YieldDuringToolExecution Optionaler bool-Parameter.

Bei der Festlegung auf true ergibt diese Aufgabe den Knoten, wenn dessen Aufgabe ausgeführt wird.

Beispiel

Im folgenden Beispiel wird die LC-Aufgabe zum Kompilieren von Lizenzen verwendet.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<!-- Item declarations, etc -->

    <Target Name="CompileLicenses">
        <LC
            Sources="@(LicxFile)"
            LicenseTarget="$(TargetFileName)"
            OutputDirectory="$(IntermediateOutputPath)"
            OutputLicenses="$(IntermediateOutputPath)$(TargetFileName).licenses"
            ReferencedAssemblies="@(ReferencePath);@(ReferenceDependencyPaths)">

            <Output
                TaskParameter="OutputLicenses"
                ItemName="CompiledLicenseFile"/>
        </LC>
    </Target>
</Project>

Siehe auch