Dokumentacja zadania MSBuild

  • Artykuł

Zadania zapewniają kod uruchamiany podczas procesu kompilacji. Zadania na poniższej liście są dołączone do programu MSBuild. Po zainstalowaniu obciążenia C++ dostępne są dodatkowe zadania używane do kompilowania projektów C++. Aby uzyskać więcej informacji, zobacz zadania języka C++.

Oprócz parametrów wymienionych w tematach w tej sekcji każde zadanie ma również następujące parametry:

Parametr Opis
Condition Opcjonalny String parametr.

Wyrażenie Boolean używane przez aparat MSBuild do określenia, czy to zadanie zostanie wykonane. Aby uzyskać informacje o warunkach obsługiwanych przez program MSBuild, zobacz Warunki.
ContinueOnError Opcjonalny parametr. Może zawierać jedną z następujących wartości:

- WarnAndContinue lub true. Gdy zadanie zakończy się niepowodzeniem, kolejne zadania w elemecie Target i kompilacja będą nadal wykonywane, a wszystkie błędy z zadania są traktowane jako ostrzeżenia.
- ErrorAndContinue. Gdy zadanie zakończy się niepowodzeniem, kolejne zadania w elemecie Target i kompilacji będą nadal wykonywane, a wszystkie błędy z zadania są traktowane jako błędy.
- ErrorAndStop lub false (wartość domyślna). Gdy zadanie zakończy się niepowodzeniem, pozostałe zadania w elemecie Target i kompilacji nie są wykonywane, a cały Target element i kompilacja są uznawane za nieudane.

Wersje programu .NET Framework przed wersją 4.5 obsługiwały tylko true wartości i false .

Aby uzyskać więcej informacji, zobacz Instrukcje: ignorowanie błędów w zadaniach.

W tej sekcji

Dodaje kilka parametrów do zadań pochodzących z Task klasy . Nie jest przeznaczony do bezpośredniego użycia.

Dodaje kilka parametrów do zadań pochodzących z TaskExtension klasy . Nie jest przeznaczony do bezpośredniego użycia.

Dodaje kilka parametrów do zadań pochodzących z ToolTaskExtension klasy . Nie jest przeznaczony do bezpośredniego użycia.

Tworzy zestaw z manifestem na podstawie jednego lub kilku plików, które są modułami lub plikami zasobów.

Opakowuje aspnet_compiler.exe— narzędzie do prekompilowania aplikacji ASP.NET.

Przypisuje identyfikatory kultury do elementów.

Akceptuje listę ciągów konfiguracji i przypisuje je do określonych projektów.

Akceptuje listę plików i dodaje <TargetPath> atrybuty, jeśli nie zostały jeszcze określone.

Wywołuje element docelowy w pliku projektu.

Łączy określone ścieżki w jedną ścieżkę.

Konwertuje ścieżkę względną lub odwołanie na ścieżkę bezwzględną.

Kopiuje pliki do nowej lokalizacji.

Tworzy nazwę manifestu w stylu C#na podstawie danej nazwy pliku resx lub innego zasobu.

Wypełnia kolekcje elementów z elementów wejściowych, co umożliwia skopiowanie elementów z jednej listy do innej.

Wypełnia właściwości z wartości wejściowych, umożliwiając skopiowanie wartości z jednej właściwości lub ciągu do innej.

Tworzy nazwę manifestu w stylu Visual Basic na podstawie danej nazwy pliku resx lub innego zasobu.

Wywołuje kompilator języka Visual C# w celu tworzenia plików wykonywalnych, bibliotek łączy dynamicznych lub modułów kodu.

Usuwa określone pliki.

Pobiera plik do określonej lokalizacji.

Zatrzymuje kompilację i rejestruje błąd na podstawie ocenianej instrukcji warunkowej.

Uruchamia określony program lub polecenie z określonymi argumentami.

Znajduje plik app.config, jeśli istnieje, na podanych listach.

Znajduje element na określonej liście, który ma pasujące elementypec.

Określa, które elementy w określonej kolekcji elementów istnieją w określonym folderze i wszystkich jego podfolderach.

Konwertuje adres URL na poprawny format adresu URL.

Dołącza numer poprawki do numeru wersji.

Generuje manifest aplikacji ClickOnce lub manifest natywny.

Zapewnia zautomatyzowany sposób wykrywania, pobierania i instalowania aplikacji oraz jej wymagań wstępnych.

Generuje manifest wdrożenia ClickOnce.

Konwertuje pliki txt i resx na pliki binarne zasobów środowiska uruchomieniowego języka wspólnego.

Generuje relację zaufania aplikacji z manifestu podstawowego oraz z TargetZone parametrów i ExcludedPermissions .

Pobiera tożsamości zestawów z określonych plików i generuje informacje o tożsamości.

Oblicza sumy kontrolne zawartości pliku lub zestawu plików.

Pobiera ścieżkę do zestawów programu .NET Framework.

Pobiera ścieżkę do zestawu Windows Software Development Kit (SDK).

Zwraca ścieżki zestawu odwołania dla różnych struktur.

Generuje plik licencji na podstawie pliku licx.

Tworzy katalogi i, w razie potrzeby, katalogi nadrzędne.

Rejestruje komunikat podczas kompilacji.

Przenosi pliki do nowej lokalizacji.

Kompiluje projekty MSBuild z innego projektu MSBuild.

Odczytuje listę elementów z pliku tekstowego.

Odczytuje metadane w określonym zestawie i dodaje niezbędne wpisy do rejestru.

Usuwa określone katalogi i wszystkie jego pliki i podkatalogi.

Usuwa zduplikowane elementy z określonej kolekcji elementów.

Określa, czy aplikacja wymaga programu .NET Framework 3.5 SP1.

  • Zadanie ResGen

Nieaktualne. Za pomocą zadania GenerateResource przekonwertuj pliki txt i resx na pliki binarne zasobów środowiska uruchomieniowego języka wspólnego.

Określa wszystkie zestawy, które zależą od określonych zestawów.

Pobiera listę co najmniej jednej nazwy bibliotek typów lub plików tlb i rozpoznaje te biblioteki typów w lokalizacjach na dysku.

Określa źródło klucza silnej nazwy

Usuwa następujące elementy w procesie kompilacji do plików generowania manifestu: wbudowane elementy, zależności, satelity, zawartość, symbole debugowania i dokumentacja.

Usuwa odwołania natywne.

Określa pliki wyjściowe dla odwołań projektów innych niż MSBuild.

Tworzy zestaw serializacji XML dla typów w określonym zestawie.

Podpisuje określony plik przy użyciu określonego certyfikatu.

Ustawia czas dostępu i modyfikacji plików.

Wyrejestrowuje określone zestawy dla celów międzyoperacyjnych MODELU COM.

Rozpakowuje archiwum zip do określonej lokalizacji.

Aktualizacje wybrane właściwości w manifeście i rezygnuje.

Wywołuje kompilator języka Visual Basic w celu tworzenia plików wykonywalnych, bibliotek linków dynamicznych lub modułów kodu.

Sprawdza, czy plik jest zgodny z oczekiwanym skrótem pliku.

Rejestruje ostrzeżenie podczas kompilacji na podstawie ocenianej instrukcji warunkowej.

Generuje plik kodu tymczasowego przy użyciu określonego wygenerowanego fragmentu kodu. Nie usuwa pliku.

Zapisuje określone elementy w określonym pliku tekstowym.

Zwraca wartości określone przez zapytanie XPath z pliku XML.

Ustawia wartości określone przez zapytanie XPath do pliku XML.

Przekształca dane wejściowe XML przy użyciu rozszerzenia Stylesheet Language Transformation (XSLT) lub skompilowanych XSLT i wyjściowych do urządzenia wyjściowego lub pliku.

Tworzy archiwum zip z zawartości katalogu.

Zobacz też