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ı | Description |
|---|---|
| HintPath | İsteğe bağlı dize. Derlemenin göreli veya mutlak yolu. |
| Name | İ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. |
COMReference
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. |
| Lcıd | İ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 TypeLibFiles parametresine 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ı | Description |
|---|---|
| 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 ResolveProjectReferencesBaş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. |
| Project | İ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 değer 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 ayarlanırsa false, 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 olarak olarak truegösterilir. |
| Ö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 olarak olarak falsegösterilir. |
| Targets | İsteğe bağlı string[]. Başvurulan projelerde oluşturulacak hedeflerin noktalı virgülle ayrılmış listesi. Varsayılan, varsayılan hedeflerini gösteren, varsayılan değeri boş olan değerdir $(ProjectReferenceBuildTargets) . |
Not
Proje başvurularının .NET Framework ile .NET Core (.NET 5 ve üzeri dahil) arasında nasıl çalıştığı arasında bir fark vardır. .NET Framework projelerde proje başvuruları geçişli değildir. Başka bir ifadeyle, Project1 Project2'ye, Project2 de Project3'e başvuruda bulunursa, 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.
Derlemek
Derleyicinin kaynak dosyalarını temsil eder.
| Öğe meta veri adı | Description |
|---|---|
| DependentUpon | İsteğe bağlı dize. Bu dosyanın doğru derlenebilmek için bağımlı olduğu dosyayı belirtir. |
| AutoGen | İsteğe bağlı boole değeri. Dosyanın Proje için Visual Studio tümleşik geliştirme ortamı (IDE) tarafından oluşturulup oluşturulmadığını gösterir. |
| Bağlantı | İsteğe bağlı dize. Dosya fiziksel olarak proje dosyasının etkisinin 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. Hiçbir zaman 2. Her zaman 3. PreserveNewest |
EmbeddedResource
Oluşturulan derlemeye eklenecek kaynakları temsil eder.
| Öğe meta veri adı | Description |
|---|---|
| DependentUpon | İsteğe bağlı dize. Bu dosyanın doğru derlenebilmek için bağımlı olduğu dosyayı belirtir |
| Oluşturucu | Gerekli dize. Bu öğe üzerinde çalıştırılacak herhangi bir dosya oluşturucunun adı. |
| LastGenOutput | Gerekli dize. Bu öğe üzerinde çalıştırılan herhangi bir dosya oluşturucu tarafından oluşturulan dosyanın adı. |
| CustomToolNamespace | Gerekli 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. Hiçbir zaman 2. Her zaman 3. PreserveNewest |
| LogicalName | Gerekli dize. Eklenmiş kaynağın mantıksal adı. |
Content
Projeye derlenmemiş, ancak eklenmiş veya onunla birlikte yayımlanabilen dosyaları temsil eder.
| Öğe meta veri adı | Description |
|---|---|
| DependentUpon | İsteğe bağlı dize. Bu dosyanın doğru derlenebilmek için bağımlı olduğu dosyayı belirtir. |
| Oluşturucu | Gerekli dize. Bu öğe üzerinde çalışan herhangi bir dosya oluşturucunun adı. |
| LastGenOutput | Gerekli dize. Bu öğe üzerinde çalıştırılan herhangi bir dosya oluşturucu tarafından oluşturulan dosyanın adı. |
| CustomToolNamespace | Gerekli 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: -Varsayılan -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. Hiçbir zaman 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ğlanmazsa, 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ı | Description |
|---|---|
| DependentUpon | İsteğe bağlı dize. Bu dosyanın doğru derlenebilmek için bağımlı olduğu dosyayı belirtir. |
| Oluşturucu | Gerekli dize. Bu öğe üzerinde çalıştırılacak herhangi bir dosya oluşturucunun adı. |
| LastGenOutput | Gerekli dize. Bu öğe üzerinde çalıştırılan herhangi bir dosya oluşturucu tarafından oluşturulan dosyanın adı. |
| CustomToolNamespace | Gerekli 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. Hiçbir zaman 2. Her zaman 3. PreserveNewest |
Assemblymetadata
olarak [AssemblyMetadata(key, value)]oluşturulacak derleme özniteliklerini temsil eder.
| Öğe meta veri adı | Description |
|---|---|
| Şunları Dahil Et: | Ö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ümler için SDK kullanan projeler için geçerlidir.
InternalsVisibleTo
Derleme öznitelikleri olarak [InternalsVisibleTo(..)] yayılacak derlemeleri belirtir.
| Öğe meta veri adı | Description |
|---|---|
| Şunları Dahil Et: | Derleme adı. |
| Anahtar | İsteğe bağlı dize. Derlemenin ortak anahtarı. |
Not
Bu öğe. .NET 5 (ve .NET Core) ve sonraki sürümler 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ının Visual Basic derleyicisi tarafından içeri aktarılması gereken derlemeleri temsil eder.