Aracılığıyla paylaş

MSBuild Ayrılmış ve Tanınmış Özellikleri

  • Makale

MSBuildProje dosyası hakkında bilgi depolamak önceden tanımlı özellik kümesini sağlar ve MSBuild ikili dosyaları.Bu özellikleri diğer aynı şekilde değerlendirilir MSBuild özellikleri.Örneğin, kullanılacak MSBuildProjectFile özelliği, siz yazarken $(MSBuildProjectFile).

MSBuild değerleri aşağıdaki tabloda ayrılmış ve iyi bilinen özellikleri önceden tanımlamayı kullanır.Ayrılmış özellikleri geçersiz kılınamaz, ancak proje dosyasında aynı adlı ortam özellikleri, genel özelliklerini veya bildirilmiş olan özellikleri kullanarak tanınan özellikleri geçersiz kılınabilir.

Ayrılmış ve Tanınmış Özellikler

Aşağıdaki tablo açıklar MSBuild özellikleri önceden tanımlanmış.

Özellik

Açıklama

Ayrılmış veya iyi bilinen

MSBuildBinPath

Mutlak yolu klasörünün nerede MSBuild bulunduğu kullanılmakta olan ikili dosyaları (örneğin, C:\Windows\Microsoft.Net\Framework\cab).Bu özellik dosyalarında başvurmak varsa yararlıdır MSBuild dizini.

Bu özellik üzerindeki son ters eğik çizgi eklemeyin.

Ayrılmış

MSBuildExtensionsPath

.NET Framework 4'te tanıtılan: varsayılan değerlerini arasındaki fark yoktur MSBuildExtensionsPath ve MSBuildExtensionsPath32.Ortam değişkeni ayarlayabilirsiniz MSBUILDLEGACYEXTENSIONSPATH varsayılan değerini davranışını etkinleştirmek için null olmayan bir değere MSBuildExtensionsPath önceki sürümlerinde.

.NET Framework 3.5 ve önceki, varsayılan değerini MSBuildExtensionsPath \Program Files\ veya \Program Files (x 86) klasörü altında geçerli işlemi, verileri bağlı olarak MSBuild alt klasör yolu gösteriyor.Örneğin, 64-bit makine 32 bitlik işlem için bu özelliği \Program Files (x 86) klasörüne işaret ediyor.64-bit makine 64-bit işlem için bu özelliği \Program dosyaları klasörüne işaret ediyor.

Bu özellik üzerindeki son ters eğik çizgi eklemeyin.

Bu konum, özel hedef dosyaları yerleştirmek için kullanışlı bir yerdir.Örneğin, hedef dosyalarınızı \Program Files\MSBuild\MyFiles\Northwind.targets yüklü ve ardından proje dosyalarında bu XML kodunu kullanarak içeri:

<Import Project="$(MSBuildExtensionsPath)\MyFiles\Northwind.targets"/>

İyi bilinen

MSBuildExtensionsPath32

Yolu MSBuild \Program dosyaları veya \Program Files (x 86) klasörü altındaki alt.Bu yol her zaman 32-bit \Program dosyalar klasörüne 32-bit makine ve \Program Files (x 86) 64-bit makine gösterir.Ayrıca bkz: MSBuildExtensionsPath ve MSBuildExtensionsPath64.

Bu özellik üzerindeki son ters eğik çizgi eklemeyin.

İyi bilinen

MSBuildExtensionsPath64

Yolu MSBuild \Program dosyaları klasörü altındaki alt.64-bit makine için bu yol her zaman \Program dosyaları klasörüne gösterir.Bir 32-bit makine için bu yolu boş olur.Ayrıca bkz: MSBuildExtensionsPath ve MSBuildExtensionsPath32.

Bu özellik üzerindeki son ters eğik çizgi eklemeyin.

İyi bilinen

MSBuildLastTaskResult

truehatasız (uyarıları olsaydı bile), önceki görev tamamlandığında, veya false önceki görev hataları sahipmiş.Bir görev bir hata oluştuğunda, genel olarak, bu projesinde olur en son şey hatasıdır.Bu nedenle, bu özellik hiçbir zaman değeri false, bu senaryolarında hariç:

Ayrılmış

MSBuildNodeCount

En fazla oluştururken kullanılan eşzamanlı işlemlerin sayısı.İçin belirtilen değer budur /maxcpucount komut satırında.Belirttiyseniz /maxcpucount sonra bir değer belirtmeden MSBuildNodeCount bilgisayarda işlemcilerin sayısını belirtir.Daha fazla bilgi için bkz. MSBuild Komut Satırı Başvurusu ve MSBuild ile Paralel Olarak Birden Çok Proje Derleme.

Ayrılmış

MSBuildProgramFiles32

32-bit program klasörünün konumu; Örneğin, C:\Program Files (x86).

Bu özellik üzerindeki son ters eğik çizgi eklemeyin.

Ayrılmış

MSBuildProjectDefaultTargets

İçinde belirtilen hedefleri tam listesi DefaultTargets özniteliği Project öğesi.Örneğin, aşağıdaki Project öğesi olan bir MSBuildDefaultTargets özellik değeri A;B;C:

<Project DefaultTargets="A;B;C" >

Ayrılmış

MSBuildProjectDirectory

Proje dosyası bulunduğu, örneğin dizinin mutlak yolu C:\MyCompany\MyProduct.

Bu özellik üzerindeki son ters eğik çizgi eklemeyin.

Ayrılmış

MSBuildProjectDirectoryNoRoot

Değerini MSBuildProjectDirectory özelliği, kök sürücüsünü hariç.

Bu özellik üzerindeki son ters eğik çizgi eklemeyin.

Ayrılmış

MSBuildProjectExtension

Süre dahil olmak üzere proje dosyasının dosya adı uzantısı; Örneğin, .proj.

Ayrılmış

MSBuildProjectFile

Dosya adı uzantısı dahil olmak üzere proje dosyası, tam dosya adı; Örneğin, MyApp.proj.

Ayrılmış

MSBuildProjectFullPath

Mutlak yolu ve dosya adı uzantısı dahil olmak üzere proje dosyası, tam dosya adı; Örneğin, C:\MyCompany\MyProduct\MyApp.proj.

Ayrılmış

MSBuildProjectName

Dosya adı uzantısı olmadan proje dosyasının dosya adı; Örneğin, Uygulamam.

Ayrılmış

MSBuildStartupDirectory

Mutlak yolu klasörünün nerede MSBuild çağrılır.Bu özellik kullanarak, bir proje ağacında belirli bir noktaya Aşağıda her şeyi her dizinde dirs.proj dosyalar oluşturmadan oluşturabilirsiniz.Bunun yerine, tek bir proje olduğunuz — aşağıda gösterildiği gibi c:\traversal.proj Örneğin,:

<Project ...>
    <ItemGroup>
        <ProjectFiles  
           Include="$
           (MSBuildStartupDirectory)
           **\*.csproj"/>
    </ItemGroup>
    <Target Name="build">
        <MSBuild    
        Projects="@(ProjectFiles)"/>
    </Target>
</Project>

Ağacında herhangi bir noktada oluşturmak için şunu yazın:

msbuild c:\traversal.proj

Bu özellik üzerindeki son ters eğik çizgi eklemeyin.

Ayrılmış

MSBuildThisFile

Dosya adı ve dosya uzantısı bölümünün MSBuildThisFileFullPath.

Ayrılmış

MSBuildThisFileDirectory

Directory kısmı MSBuildThisFileFullPath.

Son ters eğik çizgi yolda içerir.

Ayrılmış

MSBuildThisFileDirectoryNoRoot

Directory kısmı MSBuildThisFileFullPath, kök sürücüsünü hariç.

Son ters eğik çizgi yolda içerir.

Ayrılmış

MSBuildThisFileExtension

Dosya adı uzantısı bölümünün MSBuildThisFileFullPath.

Ayrılmış

MSBuildThisFileFullPath

Çalıştığı hedef içeren proje veya hedef dosyanın mutlak yolu.

İpucuİpucu

Bir hedefleri dosyasında hedefleri dosyasına göre ve orijinal proje dosyasına göre değil, göreli bir yol belirtebilirsiniz.

Ayrılmış

MSBuildThisFileName

Dosya adı kısmını MSBuildThisFileFullPath, dosya adı uzantısı olmadan.

Ayrılmış

MSBuildToolsPath

Yükleme yolu MSBuild değeri ile ilişkili sürüm MSBuildToolsVersion.

Son ters eğik çizgi yolda eklemeyin.

Bu özelliği değiştirilemiyor.

Ayrılmış

MSBuildToolsVersion

Sürümü MSBuild projesini oluşturmak için kullanılan bir araç takımı.

[!NOT]

Bir MSBuild görevleri, hedefleri ve bir uygulama oluşturmak için kullanılan araçları bir araç takımı oluşur.Derleyiciler csc.exe ve vbc.exe gibi araçlar içerir.Daha fazla bilgi için bkz. MSBuild Araç Takımı (ToolsVersion) ve Standart ve Özel Araç Takımı Yapılandırmaları.

Ayrılmış

Ayrıca bkz.

Kavramlar

MSBuild Özellikleri

Diğer Kaynaklar

MSBuild Başvurusu