LC — Zadanie

  • Artykuł

Opakowuje plik LC.exe, który generuje plik licencji na podstawie pliku licx. Aby uzyskać więcej informacji na temat pliku LC.exe, zobacz Lc.exe (Kompilator licencji).

Parametry

W poniższej tabeli opisano parametry zadania LC .

Parametr Opis
LicenseTarget Wymagany parametr interfejsu ITaskItem.

Określa plik wykonywalny, dla którego są generowane pliki licencji .
NoLogo Opcjonalny Boolean parametr.

Pomija wyświetlanie transparentu startowego firmy Microsoft.
OutputDirectory Opcjonalny String parametr.

Określa katalog, w którym mają być umieszczane wyjściowe pliki licencji .
OutputLicense Opcjonalny ITaskItem parametr wyjściowy.

Określa nazwę pliku licencji . Jeśli nie określisz nazwy, zostanie użyta nazwa pliku licx , a plik licencji zostanie umieszczony w katalogu zawierającym plik licx .
ReferencedAssemblies Opcjonalny ITaskItem[] parametr.

Określa składniki, do których należy się odwołać podczas generowania pliku licencji .
SdkToolsPath Opcjonalny String parametr.

Określa ścieżkę do narzędzi zestawu SDK, takich jak resgen.exe.
Sources Wymagany parametr interfejsu ITaskItem[].

Określa elementy zawierające składniki licencjonowane do uwzględnienia w pliku licencji . Aby uzyskać więcej informacji, zobacz dokumentację przełącznika /complist w pliku Lc.exe (kompilator licencji).

Parametry toolTaskExtension

To zadanie dziedziczy z ToolTaskExtension klasy dziedziczonej ToolTask po klasie, która dziedziczy się po Task klasie. Ten łańcuch dziedziczenia dodaje kilka parametrów do zadań, które pochodzą z nich.

W poniższej tabeli opisano parametry klas bazowych:

Parametr Opis
EchoOff Opcjonalny bool parametr.

Gdy jest ustawiona wartość true, to zadanie przekazuje /Q do wiersza polecenia cmd.exe , tak aby wiersz polecenia nie został skopiowany do pliku stdout.
EnvironmentVariables Opcjonalny String parametr tablicy.

Tablica definicji zmiennych środowiskowych oddzielona średnikami. Każda definicja powinna określać nazwę zmiennej środowiskowej i wartość oddzieloną znakiem równości. Te zmienne są przekazywane do zduplikowanego pliku wykonywalnego oprócz zwykłego bloku środowiska lub selektywnego zastępowania. Na przykład Variable1=Value1;Variable2=Value2.
ExitCode Opcjonalny Int32 parametr tylko do odczytu.

Określa kod zakończenia udostępniany przez wykonane polecenie. Jeśli zadanie zarejestrowało błędy, ale proces miał kod zakończenia 0 (powodzenie), jest to ustawione na -1.
LogStandardErrorAsError Opcjonalny bool parametr.

Jeśli trueprogram , wszystkie komunikaty odebrane w standardowym strumieniu błędów są rejestrowane jako błędy.
StandardErrorImportance Opcjonalny String parametr.

Ważność rejestrowania tekstu ze standardowego strumienia błędów.
StandardOutputImportance Opcjonalny String parametr.

Ważność, za pomocą której ma być rejestrowany tekst ze standardowego strumienia wychodzącego.
Timeout Opcjonalny Int32 parametr.

Określa czas w milisekundach, po którym plik wykonywalny zadania zostanie zakończony. Wartość domyślna to Int.MaxValue, co oznacza, że nie ma limitu czasu. Limit czasu wynosi w milisekundach.
ToolExe Opcjonalny string parametr.

Projekty mogą implementować tę funkcję, aby zastąpić element ToolName. Zadania mogą zastąpić tę wartość, aby zachować wartość ToolName.
ToolPath Opcjonalny string parametr.

Określa lokalizację, z której zadanie ładuje źródłowy plik wykonywalny. Jeśli ten parametr nie zostanie określony, zadanie używa ścieżki instalacyjnej zestawu SDK odpowiadającej wersji platformy z uruchomionym programem MSBuild.
UseCommandProcessor Opcjonalny bool parametr.

Po ustawieniu truewartości to zadanie tworzy plik wsadowy dla wiersza polecenia i wykonuje go przy użyciu procesora poleceń zamiast bezpośredniego wykonywania polecenia.
YieldDuringToolExecution Opcjonalny bool parametr.

Gdy jest ustawiona wartość true, to zadanie daje węzeł, gdy jego zadanie jest wykonywane.

Przykład

W poniższym przykładzie użyto LC zadania do kompilowania licencji.

<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>

Zobacz też