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. Doğruysa, 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 reg-free bileşeni 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ı 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.
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) .

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'daki Çözüm Gezgini'nde 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'daki Çözüm Gezgini'nde 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 öğede ç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ışlandı
- 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'daki Çözüm Gezgini'nde 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

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 öğede ç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'daki Çözüm Gezgini'nde 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ümleri 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ü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.

Ayrıca bkz.