Yaygın MSBuild proje öğeleri

MSBuild'de bir öğe, bir veya daha fazla dosyaya adlandırılmış başvurudur. Öğeler dosya adları, yollar ve sürüm numaraları gibi meta veriler içerir. Visual Studio'daki tüm proje türlerinin ortak öğeleri vardır. Bu öğeler Microsoft.Build.CommonTypes.xsd dosyasında tanımlanır.

Bu makalede tüm ortak proje öğeleri listelenir.

Başvuru

Projedeki bir derleme (yönetilen) başvuruyu temsil eder.

Öğe meta veri adı Açıklama
HintPath İsteğe bağlı dize. Derlemenin göreli veya mutlak yolu.
Veri Akışı Adı İsteğe bağlı dize. Derlemenin görünen adı, örneğin, "System.Windows.Forms."
FusionName İsteğe bağlı dize. Öğenin basit veya güçlü füzyon adını belirtir.

Bu öznitelik mevcut olduğunda, derleme dosyasının fusion adını almak için açılması gerekmediğinden zaman kazandırabilir.
SpecificVersion İsteğe bağlı boole değeri. Yalnızca fusion adındaki sürüme başvurulup başvurulmayacağını belirtir.
Diğer adlar İsteğe bağlı dize. Başvuru için tüm diğer adlar.
Özel İsteğe bağlı boole değeri. Başvurunun çıkış klasörüne kopyalanıp kopyalanmayacağını belirtir. Bu öznitelik, Visual Studio IDE'deki başvurunun Yerel Kopyala özelliğiyle eşleşir.

COM Başvurusu

Projedeki com (yönetilmeyen) bileşen başvurularını temsil eder. Bu öğe yalnızca .NET projeleri için geçerlidir.

Öğe meta veri adı Açıklama
Ad İsteğe bağlı dize. Bileşenin görünen adı.
GUID Gerekli dize. bileşeni için biçiminde {12345678-1234-1234-1234-123456781234}bir GUID.
VersionMajor Gerekli dize. Bileşenin sürüm numarasının ana bölümü. Örneğin, tam sürüm numarası "5.46" ise "5".
VersionMinor Gerekli dize. Bileşenin sürüm numarasının küçük bölümü. Örneğin, tam sürüm numarası "5.46" ise "46".
EmbedInteropTypes İsteğe bağlı boole değeri. True ise, birlikte çalışma DLL'sini oluşturmak yerine bu başvurudaki birlikte çalışma türlerini doğrudan derlemenize ekleyin.
Lcid İsteğe bağlı dize. Bileşenin LocaleID değeri.
WrapperTool İsteğe bağlı dize. Bileşende kullanılan sarmalayıcı aracının adı. Değerler şunlardır:

1. birincil
2. tlbimp
3. primaryortlbimp
4. aximp
Yalıtılmış İsteğe bağlı boole değeri. Bileşenin kayıt defteri içermeyen bir bileşen olup olmadığını belirtir.

COMFileReference

ResolveComReference hedefinin parametresine TypeLibFiles geçirilen tür kitaplıklarının listesini temsil eder. Bu öğe yalnızca .NET projeleri için geçerlidir.

Öğe meta veri adı Açıklama
WrapperTool İsteğe bağlı dize. Bileşende kullanılan sarmalayıcı aracının adı. Değerler şunlardır:

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

NativeReference

Yerel bir bildirim dosyasını veya böyle bir dosyaya başvuruyu temsil eder.

Öğe meta veri adı Açıklama
Ad Gerekli dize. Bildirim dosyasının temel adı.
HintPath Gerekli dize. Bildirim dosyasının göreli yolu.

ProjectReference

Başka bir projeye başvuru gösterir. ProjectReferenceöğeler hedef tarafından ResolveProjectReferences Başvuru öğelerine dönüştürülür, bu nedenle dönüştürme işlemi üzerine yazmazsa başvurudaki geçerli meta veriler üzerinde ProjectReferencegeçerli olabilir.

Öğe meta veri adı Açıklama
Ad İsteğe bağlı dize. Başvurunun görünen adı.
GlobalPropertiesToRemove İsteğe bağlıstring[]. Başvuruda bulunan projeyi oluştururken kaldırılacak özelliklerin adları, örneğin RuntimeIdentifier;PackOnBuild. Varsayılan olarak boş olur.
Proje İsteğe bağlı dize. Başvuru için biçiminde {12345678-1234-1234-1234-123456781234}bir GUID.
OutputItemType İsteğe bağlı dize. Hedef çıkışları yaymak için öğe türü. Varsayılan boş. Başvuru meta verileri "true" (varsayılan) olarak ayarlanırsa, hedef çıkışlar derleyici için başvurular haline gelir.
ReferenceOutputAssembly İsteğe bağlı boole değeri. olarak falseayarlanırsa, başvuruda bulunılan projenin çıkışını bu projenin Başvurusu olarak içermez, ancak yine de diğer projenin bundan önce oluşturulmasını sağlar. varsayılan değeridir true.
Özel İsteğe bağlı boole değeri. Başvurunun çıkış klasörüne kopyalanıp kopyalanmayacağını belirtir. Bu öznitelik, Visual Studio IDE'deki başvurunun Yerel Kopyala özelliğiyle eşleşir.
SetConfiguration İsteğe bağlı dize. Başvuruda bulunan projenin genel özelliğini Configuration ayarlar, örneğin Configuration=Release.
SetPlatform İsteğe bağlı dize. Başvuruda bulunan projenin genel özelliğini Platform ayarlar, örneğin Platform=AnyCPU.
SetTargetFramework İsteğe bağlı dize. Başvuruda bulunan projenin genel özelliğini TargetFramework ayarlar, örneğin TargetFramework=netstandard2.0.
SkipGetTargetFrameworkProperties İsteğe bağlı boole değeri. ise true, başvuruda bulunan projeyi en uyumlu TargetFramework değerle anlaşmadan oluşturur. varsayılan değeridir false.
Hedefler İsteğe bağlıstring[]. Başvurulan projelerde oluşturulacak hedeflerin noktalı virgülle ayrılmış listesi. Varsayılan değeri, varsayılan olarak boş olan ve varsayılan hedefleri gösteren değeridir $(ProjectReferenceBuildTargets). Visual Studio'da oluştururken (veya dotnet builddışındaMSBuild.exe), bunu belirtmek, Visual Studio'nun başvurulan projenin varsayılan hedeflerini oluşturmasını engellemez.

Not

.NET Framework ve .NET Core (.NET 5 ve üzeri dahil) arasında proje başvurularının çalışma şekli arasında bir fark vardır. .NET Framework projelerinde proje başvuruları geçişli değildir. Başka bir ifadeyle, Project1 Project2'ye başvurursa ve Project2 Project3'e başvurursa, Project1'den Project3'e karşı kod yapamazsınız. Ancak .NET Core'da (.NET 5 ve üzeri dahil), proje başvuruları geçişli olur . Project1'de Project3'e karşı kod oluşturabilirsiniz.

Derleme

Derleyicinin kaynak dosyalarını temsil eder.

Öğe meta veri adı Açıklama
DependentUpon İsteğe bağlı dize. Bu dosyanın doğru derlenecek şekilde bağımlı olduğu dosyayı belirtir.
AutoGen İsteğe bağlı boole değeri. Dosyanın Visual Studio tümleşik geliştirme ortamı (IDE) tarafından proje için oluşturulup oluşturulmadığını gösterir.
Bağlantı İsteğe bağlı dize. Dosya fiziksel olarak proje dosyasının etkisi dışında bulunduğunda görüntülenecek gösterim yolu.
Görünür İsteğe bağlı boole değeri. Dosyanın Visual Studio'da Çözüm Gezgini görüntülenip görüntülenmeyeceğini gösterir.
CopyToOutputDirectory İsteğe bağlı dize. Dosyanın çıkış dizinine kopyalanıp kopyalanmayacağını belirler. Değerler şunlardır:

1. Asla
2. Her Zaman
3. PreserveNewest

EmbeddedResource

Oluşturulan derlemeye eklenecek kaynakları temsil eder.

Öğe meta veri adı Açıklama
DependentUpon İsteğe bağlı dize. Bu dosyanın doğru derlenecek şekilde bağımlı olduğu dosyayı belirtir
Oluşturucu İsteğe bağlı dize. Bu öğede çalıştırılacak herhangi bir dosya oluşturucunun adı.
LastGenOutput İsteğe bağlı dize. Bu öğe üzerinde çalıştırılan herhangi bir dosya oluşturucu tarafından oluşturulan dosyanın adı.
CustomToolNamespace İsteğe bağlı dize. Bu öğe üzerinde çalışan herhangi bir dosya oluşturucunun kod oluşturması gereken ad alanı.
Bağlantı İsteğe bağlı dize. Dosya fiziksel olarak projenin etkisi dışında bulunuyorsa, gösterim yolu görüntülenir.
Görünür İsteğe bağlı boole değeri. Dosyanın Visual Studio'da Çözüm Gezgini görüntülenip görüntülenmeyeceğini gösterir.
CopyToOutputDirectory İsteğe bağlı dize. Dosyanın çıkış dizinine kopyalanıp kopyalanmayacağını belirler. Değerler şunlardır:

1. Asla
2. Her Zaman
3. PreserveNewest
LogicalName Gerekli dize. Eklenmiş kaynağın mantıksal adı.

Content

Projeye derlenmemiş, ancak eklenmiş veya onunla birlikte yayımlanabilir dosyaları temsil eder.

Öğe meta veri adı Açıklama
DependentUpon İsteğe bağlı dize. Bu dosyanın doğru derlenecek şekilde bağımlı olduğu dosyayı belirtir.
Oluşturucu İsteğe bağlı dize. Bu öğe üzerinde çalışan herhangi bir dosya oluşturucunun adı.
LastGenOutput İsteğe bağlı dize. Bu öğede çalıştırılan herhangi bir dosya oluşturucu tarafından oluşturulan dosyanın adı.
CustomToolNamespace İsteğe bağlı dize. Bu öğe üzerinde çalışan herhangi bir dosya oluşturucunun kod oluşturması gereken ad alanı.
Bağlantı İsteğe bağlı dize. Dosya fiziksel olarak projenin etkisi dışında bulunuyorsa görüntülenecek gösterim yolu.
PublishState Gerekli dize. İçeriğin yayımlama durumu:

-Temerrüt
-Dahil
-Dış -lanan
-Datafile
-Önkoşul
IsAssembly İsteğe bağlı boole değeri. Dosyanın bir derleme olup olmadığını belirtir.
Görünür İsteğe bağlı boole değeri. Dosyanın Visual Studio'da Çözüm Gezgini görüntülenip görüntülenmeyeceğini gösterir.
CopyToOutputDirectory İsteğe bağlı dize. Dosyanın çıkış dizinine kopyalanıp kopyalanmayacağını belirler. Değerler şunlardır:

1. Asla
2. Her Zaman
3. PreserveNewest
TargetPath İsteğe bağlı dize. Dosya adı da dahil olmak üzere bir öğenin çıkış yolu (yapılandırmaya ve/veya platforma özgü çıkış dizinine göre). Bu, sağlanmışsa meta verileri dikkate Link alır. TargetPath sağlanmadıysa, derleme işlemi sırasında hesaplanır. Bkz . AssignTargetPath.

Hiçbiri

Derleme işleminde rolü olmaması gereken dosyaları temsil eder.

Öğe meta veri adı Açıklama
DependentUpon İsteğe bağlı dize. Bu dosyanın doğru derlenecek şekilde bağımlı olduğu dosyayı belirtir.
Oluşturucu İsteğe bağlı dize. Bu öğede çalıştırılacak herhangi bir dosya oluşturucunun adı.
LastGenOutput İsteğe bağlı dize. Bu öğe üzerinde çalıştırılan herhangi bir dosya oluşturucu tarafından oluşturulan dosyanın adı.
CustomToolNamespace İsteğe bağlı dize. Bu öğe üzerinde çalışan herhangi bir dosya oluşturucunun kod oluşturması gereken ad alanı.
Bağlantı İsteğe bağlı dize. Dosya fiziksel olarak projenin etkisi dışında bulunuyorsa görüntülenecek gösterim yolu.
Görünür İsteğe bağlı boole değeri. Dosyanın Visual Studio'da Çözüm Gezgini görüntülenip görüntülenmeyeceğini gösterir.
CopyToOutputDirectory İsteğe bağlı dize. Dosyanın çıkış dizinine kopyalanıp kopyalanmayacağını belirler. Değerler şunlardır:

1. Asla
2. Her Zaman
3. PreserveNewest

AssemblyMetadata

olarak [AssemblyMetadata(key, value)]oluşturulacak derleme özniteliklerini temsil eder.

Öğe meta veri adı Açıklama
Ekle Öznitelik oluşturucusunda ilk parametre (anahtar) AssemblyMetadataAttribute olur.
Değer Gerekli dize. Öznitelik oluşturucusunda AssemblyMetadataAttribute ikinci parametre (değer) olur.

Not

Bu öğe .NET 5 (ve .NET Core) ve sonraki sürümleri için SDK kullanan projeler için geçerlidir.

InternalsVisibleTo

Derleme öznitelikleri olarak [InternalsVisibleTo(..)] yayılacak derlemeleri belirtir.

Öğe meta veri adı Açıklama
Ekle Derleme adı.
Anahtar İsteğe bağlı dize. Derlemenin ortak anahtarı.

Not

Bu öğe .NET 5 (ve .NET Core) ve sonraki sürümleri için SDK kullanan projeler için geçerlidir.

BaseApplicationManifest

Derleme için temel uygulama bildirimini temsil eder ve ClickOnce dağıtım güvenlik bilgilerini içerir.

CodeAnalysisImport

İçeri aktaracak FxCop projesini temsil eder.

İçeri Aktar

Ad alanları Visual Basic derleyicisi tarafından içeri aktarılması gereken derlemeleri temsil eder.

Klasör

Bu öğe yalnızca Visual Studio tarafından boş bir klasör için yer tutucu olarak kullanılır. Klasör doldurulduğunda, başka bir öğeyle değiştirilir.

Ayrıca bkz.