Project öğesi (MSBuild)

  • Makale

MSBuild proje dosyasının gerekli kök öğesi.

Sözdizimi

<Project InitialTargets="TargetA;TargetB"
         DefaultTargets="TargetC;TargetD"
         TreatAsLocalProperty="PropertyA;PropertyB"
         ToolsVersion="<version number>"
         Sdk="name[/version]"
         xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Sdk... />
    <Choose>... </Choose>
    <PropertyGroup>... </PropertyGroup>
    <ItemGroup>... </ItemGroup>
    <Target>... </Target>
    <UsingTask.../>
    <ProjectExtensions>... </ProjectExtensions>
    <Import... />
</Project>

Öznitelikler ve öğeler

Öznitelikler, alt ve üst öğeler aşağıdaki bölümlerde açıklanmaktadır.

Öznitelikler

Öznitelik Tanım
DefaultTargets İsteğe bağlı öznitelik.

Varsayılan hedef veya hedef belirtilmemişse derlemenin giriş noktası olur. Birden çok hedef noktalı virgül (;) ayrılmıştır.

Öznitelikte DefaultTargets veya MSBuild komut satırında varsayılan hedef belirtilmezse, içeri aktarma öğeleri değerlendirildikten sonra altyapı proje dosyasındaki ilk hedefi yürütür.
InitialTargets İsteğe bağlı öznitelik.

Öznitelikte DefaultTargets veya komut satırında belirtilen hedeflerden önce çalıştırılacak ilk hedef veya hedefler. Birden çok hedef noktalı virgülle (;) ayrılmıştır. birden çok içeri aktarılan dosya tanımlarsa InitialTargets, belirtilen tüm hedefler içeri aktarmalarla karşılaşılma sırasına göre çalıştırılır.
Sdk İsteğe bağlı öznitelik.

.proj dosyasına eklenen örtük İçeri Aktarma deyimleri oluşturmak için kullanılacak SDK adı ve isteğe bağlı sürüm. Sürüm belirtilmezse, MSBuild varsayılan sürümü çözümlemeyi dener. Örneğin, <Project Sdk="Microsoft.NET.Sdk" /> veya <Project Sdk="My.Custom.Sdk/1.0.0" />.
ToolsVersion İsteğe bağlı öznitelik.

ARAÇ KÜMESI MSBuild'in sürümü, $(MSBuildBinPath) ve $(MSBuildToolsPath) değerlerini belirlemek için kullanır.
TreatAsLocalProperty İsteğe bağlı öznitelik.

Genel olarak kabul edilmeyecek özellik adları. Bu öznitelik, belirli komut satırı özelliklerinin bir proje veya hedef dosyasında ayarlanan özellik değerlerini ve sonraki tüm içeri aktarmaları geçersiz kılmasını engeller. Birden çok özellik noktalı virgülle ayrılmıştır (;).

Normalde, genel özellikler proje veya hedefler dosyasında ayarlanan özellik değerlerini geçersiz kılar. Özellik değerde TreatAsLocalProperty listeleniyorsa, genel özellik değeri bu dosyada ayarlanan özellik değerlerini ve sonraki içeri aktarmaları geçersiz kılmaz. Daha fazla bilgi için bkz . Nasıl yapılır: Farklı seçeneklerle aynı kaynak dosyaları oluşturma. Not: -property (veya -p) anahtarını kullanarak bir komut isteminde genel özellikleri ayarlarsınız. Ayrıca, MSBuild görevinin özniteliğini kullanarak çok projeli bir derlemedeki alt projelerin Properties genel özelliklerini ayarlayabilir veya değiştirebilirsiniz. Daha fazla bilgi için bkz . MSBuild görevi.
xmlns İsteğe bağlı öznitelik.

Belirtildiğinde özniteliğinin xmlns değerine http://schemas.microsoft.com/developer/msbuild/2003sahip olması gerekir.

Alt öğeleri

Öğe Tanım
Seçin İsteğe bağlı öğe.

Değerlendirilecek bir öğe kümesini ve/veya PropertyGroup öğe kümesini ItemGroup seçmek için alt öğeleri değerlendirir.
İçeri Aktar İsteğe bağlı öğe.

Proje dosyasının başka bir proje dosyasını içeri aktarmasını sağlar. Projede sıfır veya daha fazla Import öğe olabilir.
ImportGroup İsteğe bağlı öğe.

İsteğe bağlı bir koşul altında gruplandırılmış bir öğe koleksiyonu Import içerir.
Itemgroup İsteğe bağlı öğe.

Tek tek öğeler için bir gruplandırma öğesi. Öğeler Item öğesi kullanılarak belirtilir. Projede sıfır veya daha fazla ItemGroup öğe olabilir.
Itemdefinitiongroup İsteğe bağlı öğe.

Varsayılan olarak, projedeki tüm öğelere uygulanan meta veri değerleri olan bir Öğe Tanımları kümesi tanımlamanızı sağlar. ItemDefinitionGroup, görevi ve görevi kullanma gereksinimini CreateItem aşıyor CreateProperty .
ProjectExtensions İsteğe bağlı öğe.

MSBuild olmayan bilgileri bir MSBuild proje dosyasında kalıcı hale getirmek için bir yol sağlar. Projede sıfır veya bir ProjectExtensions öğe olabilir.
Propertygroup İsteğe bağlı öğe.

Tek tek özellikler için bir gruplandırma öğesi. Özellikler, Property öğesi kullanılarak belirtilir. Projede sıfır veya daha fazla PropertyGroup öğe olabilir.
Sdk İsteğe bağlı öğe.

MSBuild proje SDK'sı başvurur. Bu öğe Sdk özniteliğine alternatif olarak kullanılabilir.
Hedef İsteğe bağlı öğe.

MSBuild'in sıralı olarak yürütülmesi için bir dizi görev içerir. Görevler, Görev öğesi kullanılarak belirtilir. Projede sıfır veya daha fazla Target öğe olabilir.
Usingtask İsteğe bağlı öğe.

MSBuild'de görevleri kaydetmek için bir yol sağlar. Projede sıfır veya daha fazla UsingTask öğe olabilir.

Üst öğeler

Yok.

Ayrıca bkz.