Udostępnij za pośrednictwem


Wspólne elementy projektów MSBuild

W programie MSBuild element jest nazwanym odwołaniem do co najmniej jednego pliku. Elementy zawierają metadane, takie jak nazwy plików, ścieżki i numery wersji. Wszystkie typy projektów w programie Visual Studio mają kilka wspólnych elementów. Te elementy są zdefiniowane w pliku Microsoft.Build.CommonTypes.xsd.

W tym artykule wymieniono wszystkie typowe elementy projektu.

Odwołanie

Reprezentuje odwołanie do zestawu (zarządzanego) w projekcie.

Nazwa metadanych elementu opis
HintPath Ciąg opcjonalny. Względna lub bezwzględna ścieżka zestawu.
Nazwisko Ciąg opcjonalny. Nazwa wyświetlana zestawu, na przykład "System.Windows.Forms".
FusionName Ciąg opcjonalny. Określa prostą lub silną nazwę łączenia elementu.

Gdy ten atrybut jest obecny, może zaoszczędzić czas, ponieważ plik zestawu nie musi być otwarty, aby uzyskać nazwę łączenia.
Określona wersja Opcjonalna wartość logiczna. Określa, czy należy odwoływać się tylko do wersji w nazwie łączenia.
Aliasy Ciąg opcjonalny. Wszystkie aliasy odwołania.
Prywatne Opcjonalna wartość logiczna. Określa, czy odwołanie powinno zostać skopiowane do folderu wyjściowego. Ten atrybut jest zgodny z właściwością Copy Local odwołania w środowisku IDE programu Visual Studio.

COMReference

Reprezentuje odwołanie do składnika COM (niezarządzanego) w projekcie. Ten element ma zastosowanie tylko do projektów .NET.

Nazwa metadanych elementu opis
Nazwa/nazwisko Ciąg opcjonalny. Nazwa wyświetlana składnika.
Identyfikator GUID Wymagany ciąg. Identyfikator GUID składnika w postaci {12345678-1234-1234-1234-123456781234}.
VersionMajor Wymagany ciąg. Główna część numeru wersji składnika. Na przykład "5", jeśli pełny numer wersji to "5.46".
VersionMinor Wymagany ciąg. Pomocnicza część numeru wersji składnika. Na przykład "46", jeśli pełny numer wersji to "5.46".
EmbedInteropTypes Opcjonalna wartość logiczna. Jeśli wartość true, osadź typy międzyoperacyjności z tego odwołania bezpośrednio do zestawu, a nie generując biblioteki DLL międzyoperacyjności.
Identyfikator LCID Ciąg opcjonalny. LocaleID składnika.
OtokaTool Ciąg opcjonalny. Nazwa narzędzia otoki używanego w składniku. Wartości to:

1. podstawowy
2. tlbimp
3. primaryortlbimp
4. aximp
Izolowana Opcjonalna wartość logiczna. Określa, czy składnik jest składnikiem bez reg.

COMFileReference

Reprezentuje listę bibliotek typów, które są przekazywane do TypeLibFiles parametru obiektu docelowego ResolveComReference . Ten element ma zastosowanie tylko do projektów .NET.

Nazwa metadanych elementu opis
OtokaTool Ciąg opcjonalny. Nazwa narzędzia otoki używanego w składniku. Wartości to:

1. podstawowy
2. tlbimp
3. primaryortlbimp
4. aximp

NativeReference

Reprezentuje natywny plik manifestu lub odwołanie do takiego pliku.

Nazwa metadanych elementu opis
Nazwa/nazwisko Wymagany ciąg. Nazwa podstawowa pliku manifestu.
HintPath Wymagany ciąg. Względna ścieżka pliku manifestu.

Wnioskowanie projektu

Reprezentuje odwołanie do innego projektu. ProjectReference elementy są przekształcane w elementy referencyjne przez ResolveProjectReferences element docelowy, więc wszystkie prawidłowe metadane w odwołaniu mogą być prawidłowe w ProjectReferencedniu , jeśli proces przekształcania go nie zastępuje.

Nazwa metadanych elementu opis
Nazwa/nazwisko Ciąg opcjonalny. Nazwa wyświetlana odwołania.
GlobalPropertiesToRemove Opcjonalnystring[]. Nazwy właściwości do usunięcia podczas kompilowania przywołytowanego projektu, na przykład RuntimeIdentifier;PackOnBuild. Wartości domyślne są puste.
Project Ciąg opcjonalny. Identyfikator GUID odwołania w postaci {12345678-1234-1234-1234-123456781234}.
OutputItemType Ciąg opcjonalny. Typ elementu do emitowania docelowych danych wyjściowych. Wartość domyślna jest pusta. Jeśli metadane odwołania są ustawione na wartość "true" (wartość domyślna), docelowe dane wyjściowe staną się odwołaniami do kompilatora.
ReferenceOutputAssembly Opcjonalna wartość logiczna. Jeśli ustawiono wartość false, nie zawiera danych wyjściowych przywołynego projektu jako odwołania do tego projektu, ale nadal zapewnia, że inne kompilacje projektu będą kompilowane przed tym projektem. Wartość domyślna to true.
Prywatne Opcjonalna wartość logiczna. Określa, czy odwołanie powinno zostać skopiowane do folderu wyjściowego. Ten atrybut jest zgodny z właściwością Copy Local odwołania w środowisku IDE programu Visual Studio.
SetConfiguration Ciąg opcjonalny. Ustawia właściwość Configuration globalną dla przywołytowanego projektu, na przykład Configuration=Release.
SetPlatform Ciąg opcjonalny. Ustawia właściwość Platform globalną dla przywołytowanego projektu, na przykład Platform=AnyCPU.
SetTargetFramework Ciąg opcjonalny. Ustawia właściwość TargetFramework globalną dla przywołytowanego projektu, na przykład TargetFramework=netstandard2.0.
SkipGetTargetFrameworkProperties Opcjonalna wartość logiczna. Jeśli trueelement , kompiluje przywołyny projekt bez negocjowania najbardziej zgodnej TargetFramework wartości. Wartość domyślna to false.
Elementy docelowe Opcjonalnystring[]. Rozdzielona średnikami lista obiektów docelowych w projektach, do których należy utworzyć odwołanie. Wartość domyślna to wartość $(ProjectReferenceBuildTargets), która domyślnie ma wartość pustą, wskazującą domyślne obiekty docelowe. Podczas kompilowania w programie Visual Studio (w przeciwieństwie do MSBuild.exe programu lub dotnet build) określenie tego elementu nie uniemożliwia programowi Visual Studio kompilowania domyślnych obiektów docelowych projektu, do których się odwołujesz.

Uwaga

Istnieje różnica między sposobem działania odwołań projektu między programem .NET Framework i platformą .NET Core (w tym platformą .NET 5 i nowszymi wersjami). W projektach .NET Framework odwołania do projektu nie są przechodnie. Oznacza to, że jeśli program Project1 odwołuje się do programu Project2 i Project2 odwołuje się do programu Project3, nie można kodować względem programu Project3 z programu Project1. Jednak w programie .NET Core (w tym .NET 5 lub nowszym) odwołania do projektu są przechodnie. Kod można wykonać względem programu Project3 w programie Project1.

Kompilowanie

Reprezentuje pliki źródłowe kompilatora.

Nazwa metadanych elementu opis
Zależnaodpopowiedz Ciąg opcjonalny. Określa plik, który jest zależny od poprawnego kompilowania.
Autogen Opcjonalna wartość logiczna. Wskazuje, czy plik został wygenerowany dla projektu przez zintegrowane środowisko projektowe (IDE) programu Visual Studio.
Link Ciąg opcjonalny. Ścieżka notacyjna, która ma być wyświetlana, gdy plik znajduje się fizycznie poza wpływem pliku projektu.
Widoczna Opcjonalna wartość logiczna. Wskazuje, czy plik ma być wyświetlany w Eksplorator rozwiązań w programie Visual Studio.
CopyToOutputDirectory Ciąg opcjonalny. Określa, czy skopiować plik do katalogu wyjściowego. Wartości to:

1. Nigdy
2. Zawsze
3. ZachowajNowy

EmbeddedResource

Reprezentuje zasoby, które mają być osadzone w wygenerowanych zestawach.

Nazwa metadanych elementu opis
Zależnaodpopowiedz Ciąg opcjonalny. Określa plik, od który ten plik zależy od poprawnego skompilowania
Generator Ciąg opcjonalny. Nazwa dowolnego generatora plików uruchomionego w tym elemencie.
LastGenOutput Ciąg opcjonalny. Nazwa pliku, który został utworzony przez dowolny generator plików uruchomiony w tym elemencie.
CustomToolNamespace Ciąg opcjonalny. Przestrzeń nazw, w której każdy generator plików uruchomiony w tym elemencie powinien utworzyć kod.
Link Ciąg opcjonalny. Ścieżka notacyjna jest wyświetlana, jeśli plik znajduje się fizycznie poza wpływem projektu.
Widoczna Opcjonalna wartość logiczna. Wskazuje, czy plik ma być wyświetlany w Eksplorator rozwiązań w programie Visual Studio.
CopyToOutputDirectory Ciąg opcjonalny. Określa, czy skopiować plik do katalogu wyjściowego. Wartości to:

1. Nigdy
2. Zawsze
3. ZachowajNowy
LogicalName Wymagany ciąg. Nazwa logiczna osadzonego zasobu.

Zawartość

Reprezentuje pliki, które nie są kompilowane w projekcie, ale mogą być osadzone lub publikowane razem z nim.

Nazwa metadanych elementu opis
Zależnaodpopowiedz Ciąg opcjonalny. Określa plik, który jest zależny od poprawnego kompilowania.
Generator Ciąg opcjonalny. Nazwa dowolnego generatora plików uruchomionego w tym elemencie.
LastGenOutput Ciąg opcjonalny. Nazwa pliku, który został utworzony przez dowolny generator plików, który został uruchomiony w tym elemencie.
CustomToolNamespace Ciąg opcjonalny. Przestrzeń nazw, w której każdy generator plików uruchomiony w tym elemencie powinien utworzyć kod.
Link Ciąg opcjonalny. Ścieżka notacyjna do wyświetlenia, jeśli plik znajduje się fizycznie poza wpływem projektu.
PublishState Wymagany ciąg. Stan publikowania zawartości:

-Domyślny
-Zawarte
-Wykluczone
-Datafile
-Warunek wstępny
IsAssembly Opcjonalna wartość logiczna. Określa, czy plik jest zestawem.
Widoczna Opcjonalna wartość logiczna. Wskazuje, czy plik ma być wyświetlany w Eksplorator rozwiązań w programie Visual Studio.
CopyToOutputDirectory Ciąg opcjonalny. Określa, czy skopiować plik do katalogu wyjściowego. Wartości to:

1. Nigdy
2. Zawsze
3. ZachowajNowy
TargetPath Ciąg opcjonalny. Ścieżka wyjściowa (względem katalogu wyjściowego specyficznego dla konfiguracji i/lub platformy) elementu, w tym nazwy pliku. Uwzględnia to metadane Link , jeśli zostały podane. Jeśli parametr TargetPath nie jest podany, jest obliczany podczas procesu kompilacji. Zobacz AssignTargetPath.

Brak

Reprezentuje pliki, które nie powinny mieć roli w procesie kompilacji.

Nazwa metadanych elementu opis
Zależnaodpopowiedz Ciąg opcjonalny. Określa plik, który jest zależny od poprawnego kompilowania.
Generator Ciąg opcjonalny. Nazwa dowolnego generatora plików uruchomionego w tym elemencie.
LastGenOutput Ciąg opcjonalny. Nazwa pliku, który został utworzony przez dowolny generator plików uruchomiony w tym elemencie.
CustomToolNamespace Ciąg opcjonalny. Przestrzeń nazw, w której każdy generator plików uruchomiony w tym elemencie powinien utworzyć kod.
Link Ciąg opcjonalny. Ścieżka notacyjna do wyświetlenia, jeśli plik znajduje się fizycznie poza wpływem projektu.
Widoczna Opcjonalna wartość logiczna. Wskazuje, czy plik ma być wyświetlany w Eksplorator rozwiązań w programie Visual Studio.
CopyToOutputDirectory Ciąg opcjonalny. Określa, czy skopiować plik do katalogu wyjściowego. Wartości to:

1. Nigdy
2. Zawsze
3. ZachowajNowy

AssemblyMetadata

Reprezentuje atrybuty zestawu, które mają być generowane jako [AssemblyMetadata(key, value)].

Nazwa metadanych elementu opis
Uwzględnij Staje się pierwszym parametrem (kluczem) w konstruktorze atrybutu AssemblyMetadataAttribute .
Wartość Wymagany ciąg. Staje się drugim parametrem (wartością) w konstruktorze atrybutu AssemblyMetadataAttribute .

Uwaga

Ten element dotyczy projektów korzystających z zestawu SDK dla platformy .NET 5 (i .NET Core) oraz nowszych wersji.

InternalsVisibleTo

Określa zestawy, które mają być emitowane jako [InternalsVisibleTo(..)] atrybuty zestawu.

Nazwa metadanych elementu opis
Uwzględnij Nazwa zestawu.
Klucz Ciąg opcjonalny. Klucz publiczny zestawu.

Uwaga

Ten element dotyczy projektów korzystających z zestawu SDK dla platformy .NET 5 (i .NET Core) oraz nowszych wersji.

BaseApplicationManifest

Reprezentuje podstawowy manifest aplikacji dla kompilacji i zawiera informacje o zabezpieczeniach wdrożenia Technologii ClickOnce.

CodeAnalysisImport

Reprezentuje projekt FxCop do zaimportowania.

Importuj

Reprezentuje zestawy, których przestrzenie nazw powinny być importowane przez kompilator języka Visual Basic.

Folder

Ten element jest używany tylko przez program Visual Studio jako symbol zastępczy pustego folderu. Po wypełnieniu folderu zostanie on zastąpiony przez inny element.

Zobacz też