Ortak MSBuild proje öğeleri

MSBuild'de bir öğe, dosya adları gibi bir veya daha fazla dizeye 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, MSBuild'in kendisinde tanımlanan tüm ortak proje öğeleri listelenir. .NET SDK tarafından sağlanan öğeler ve özellikler , Microsoft.Net.Sdk için MSBuild başvurusu sayfasında belgelenmiştir.

MSBuild isteğe bağlı meta veriler için herhangi bir değer ayarlamaz ve kümeyi kaldırma meta verileri boş bir dizeye eşdeğerdir. Bu nedenle, isteğe bağlı meta veriler için varsayılan değer boş dizedir. Ancak meta veri değerleri bazen örtük olarak içeri aktarılan SDK dosyalarında ayarlanır. Değerler, başvurulmakta olan SDK'ya bağlıdır.

Reference

Projedeki bir .NET derlemesi (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.
Aliases	İsteğe bağlı dize. Başvuru için tüm diğer adlar.
Private	İ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. varsayılan olarak false.

Note

Reference Öğe türü, yerel COM nesneleri için önceden oluşturulmuş sarmalayıcı derlemelerine başvurmak için de kullanılabilir. Örneğin, bir PIA (Birincil Birlikte Çalışma Derlemesi) oluştururken kullandıysanıztlbimp.exe. Bu tür bir başvuru, DERLEME zamanında COM sarmalayıcıları oluşturmak için MSBuild'in algoritmasına güvenmek yerine, BILINEN girişlerle COM sarmalayıcı derlemelerini önceden oluşturmak istediğinizde uygun bir seçimdir ve bu da MSBuild'in çalıştırıldığı derleme makinesinde sistem kayıt defterinin durumuna bağımlılık sağlar.

COMReference

Projedeki com (yönetilmeyen) bileşen başvurularını temsil eder. Bu öğe, sarmalayıcı derlemelerini oluşturan ResolveComReference görevi tarafından kullanılır veya kullanılırsa EmbedInteropTypes birlikte çalışma türlerini derlemenize ekler. Bu tür bir başvuru kullanıldığında, başvurulan COM nesnesini aramak için kullanılan derleme makinesinde sistem kayıt defterine bağımlılık sağlanır. Ürünler makineye yüklendiğinde, güncelleştirildiğinde veya kaldırıldığında (veya aynı derlemeyi farklı bir makinede çalıştırdığınızda) kayıt defterindeki COM yapıtları ve COM girişleri değişebilir ve derleme mantığı değişmemiş olsa bile farklı bir sarmalayıcı derlemesi oluşturabilir.

Bu öğe non-.NET projeler için geçerli değildir.

Öğe meta veri adı	Description
Name	İsteğe bağlı dize. Bileşenin görünen adı.
Guid	Gerekli dize. bileşeni için {12345678-1234-1234-1234-123456781234}biçiminde 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
Isolated	İsteğe bağlı boole değeri. Bileşenin kayıt defteri içermeyen bir bileşen olup olmadığını belirtir. varsayılan olarak false.

Bkz . COM başvurularında sorun giderme.

COMFileReference

Sistem kayıt defterini kullanmak yerine dosya yoluna göre başvurulacak tür kitaplıklarının listesini temsil eder. Derlemeyi çalıştıran hesabın derleme sunucusunda kayıt defterini düzenlemek için yükseltilmiş ayrıcalıkları olmadığından veya derlemenin kayıt defterinin durumuna bağımlılığı olmasını istemediğinizden, derleme makinesinin kayıt defterine bağımlılıktan kaçınmak istediğiniz durumlarda, bu başvuru türü COMReference'a iyi bir alternatif olabilir. Bir sistem yolundaki bir yapıta başvurmak için kullanırsanız COMFileReference , derlemenizin sistem durumuna bağımlılığı vardır. Sistem yapıtı, ürünlerin ne zaman yüklendiği, güncelleştirildiği veya kaldırdığı (veya aynı derlemeyi farklı bir makinede çalıştırdığınızda) sistem durumundaki bir değişiklik nedeniyle değişirse, derleme mantığı değişmemiş olsa bile sarmalayıcı derlemesi değişebilir. Tutarlı bir derleme sonucu elde etmek için COM yapıtının bilinen bir kopyasını, örneğin proje veya çözüm klasörünüz altında denetlediğiniz bir yerde önbelleğe alabilir ve sistem yapıtı yerine buna başvurabilirsiniz.

Bu öğe non-.NET projeler için geçerli değildir.

Öğe meta veri adı	Description
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. Varsayılan değer false'tur.
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

Bkz . COM başvurularında sorun giderme.

NativeReference

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

Öğe meta veri adı	Description
Name	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, hedefi tarafından ResolveProjectReferences öğelerine dönüştürülür, bu nedenle dönüştürme işlemi üzerine yazmazsa başvurudaki tüm geçerli meta veriler ProjectReferenceüzerinde geçerli olabilir.

Öğe meta veri adı	Description
Name	İ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şvurunun GUID değeri {12345678-1234-1234-1234-123456781234}.
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 olarak true.
BuildReference	İsteğe bağlı boole değeri. varsayılan olarak true. olarak ayarlanırsa false, bu ProjectReference MSBuild tarafından derlenmez. Varsayılan hedefleri (aşağıdaki 'Hedefler' bölümüne bakın) hiç çağrılmaz.
Private	İ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 proje için genel özellik Configuration ayarlar, örneğin Configuration=Release.
SetPlatform	İsteğe bağlı dize. Başvuruda bulunan proje için genel özellik Platform ayarlar, örneğin Platform=AnyCPU.
SetTargetFramework	İsteğe bağlı dize. Başvuruda bulunan proje için genel özellik TargetFramework ayarlar, örneğin TargetFramework=netstandard2.0.
SkipGetTargetFrameworkProperties	İsteğe bağlı boole değeri. true, en uyumlu TargetFramework değeri görüşmeden başvuruda bulunan projeyi oluşturur. varsayılan olarak false.
Targets	İsteğe bağlı string[]. Başvurulan projelerde oluşturulacak hedeflerin noktalı virgülle ayrılmış listesi. Varsayılan, varsayılan hedefleri gösteren boş olan $(ProjectReferenceBuildTargets)değeridir. Visual Studio'da oluştururken (MSBuild.exe veya dotnet builddeğil) bunu belirtmek, Visual Studio'nun başvurulan projenin varsayılan hedeflerini oluşturmasını engellemez.

Note

.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.

Compile

Derleyicinin kaynak dosyalarını temsil eder.

Öğe meta veri adı	Description
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. varsayılan olarak false.
Link	İsteğe bağlı dize. Dosya fiziksel olarak proje dosyasının etkisi dışında bulunduğunda görüntülenecek gösterim yolu.
Visible	İ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. varsayılan olarak true.
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 4. IfDifferent Never varsayılan olarak ayarlanır; DefineExplicitDefaults aksi takdirde, boş dize varsayılan olarak ayarlanırtrue.

EmbeddedResource

Oluşturulan derlemeye eklenecek kaynakları temsil eder.

Öğe meta veri adı	Description
Culture	İsteğe bağlı dize. Kaynak dosyasının kültürünü belirtir. Belirtilirse, derleme işlemi dosya uzantısına göre kültürü otomatik olarak çıkaramaz (derlemeyi barındıran makinede .NET/OS için kullanılabilen kültürlere bağlıdır). Culture={culture identifier} veya WithCulture=false meta verilerinin ayarlanması kesinlikle önerilir.
WithCulture	İsteğe bağlı bool. Dosyanın kültürden bağımsız olduğunu ve AssignCulture tarafından kültür algılamanın atlanması gerektiğini belirtir. Culture={culture identifier} veya WithCulture=false meta verilerinin ayarlanması kesinlikle önerilir.
DependentUpon	İsteğe bağlı dize. Bu dosyanın doğru derlenecek şekilde bağımlı olduğu dosyayı belirtir
Generator	İ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ı.
Link	İsteğe bağlı dize. Dosya fiziksel olarak projenin etkisi dışında bulunuyorsa, gösterim yolu görüntülenir.
Visible	İ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. Asla 2. Her Zaman 3. PreserveNewest 4. IfDifferent Never varsayılan olarak ayarlanır; DefineExplicitDefaults aksi takdirde, boş dize varsayılan olarak ayarlanırtrue.
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ı	Description
DependentUpon	İsteğe bağlı dize. Bu dosyanın doğru derlenecek şekilde bağımlı olduğu dosyayı belirtir.
Generator	İ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ı.
Link	İ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.
Visible	İ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. Asla 2. Her Zaman 3. PreserveNewest 4. IfDifferent Never varsayılan olarak ayarlanır; DefineExplicitDefaults aksi takdirde, boş dize varsayılan olarak ayarlanırtrue.
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 Link meta verilerine saygı gösterir. TargetPath sağlanmadıysa, derleme işlemi sırasında hesaplanır. Bkz . AssignTargetPath.

None

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 derlenecek şekilde bağımlı olduğu dosyayı belirtir.
Generator	İ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ı.
Link	İsteğe bağlı dize. Dosya fiziksel olarak projenin etkisi dışında bulunuyorsa görüntülenecek gösterim yolu.
Visible	İ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. Asla 2. Her Zaman 3. PreserveNewest 4. IfDifferent Never varsayılan olarak ayarlanır; DefineExplicitDefaults aksi takdirde, boş dize varsayılan olarak ayarlanırtrue.

AssemblyMetadata

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

Öğe meta veri adı	Description
Include	AssemblyMetadataAttribute öznitelik oluşturucusunda ilk parametre (anahtar) olur.
Value	Gerekli dize. AssemblyMetadataAttribute öznitelik oluşturucusunda ikinci parametre (değer) olur.

Note

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

InternalsVisibleTo

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

Öğe meta veri adı	Description
Include	Derleme adı.
Key	İsteğe bağlı dize. Derlemenin ortak anahtarı.

Note

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.

Import

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

Folder

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 bakınız

• Ortak MSBuild proje özelliklerini
• Ortak MSBuild öğe meta verilerini