AspNetCompiler görevi

  • Makale

GörevAspNetCompiler, ASP.NET uygulamalarını önceden derlemeye yönelik bir yardımcı program olan aspnet_compiler.exe dosyasını sarmalar.

Görev parametreleri

Aşağıdaki tabloda görevin parametreleri AspNetCompiler açıklanmaktadır.

Parametre Açıklama
AllowPartiallyTrustedCallers İsteğe bağlı Boolean parametre.

Bu parametre ise true, tanımlayıcı ad derlemesi kısmen güvenilen arayanlara izin verir.
Clean İsteğe bağlı Boolean parametre

Bu parametre ise true, önceden derlenmiş uygulama temiz oluşturulur. Önceden derlenmiş tüm bileşenler yeniden derlenir. false varsayılan değerdir. Bu parametre, aspnet_compiler.exe dosyasındaki -c anahtarına karşılık gelir.
Debug İsteğe bağlı Boolean parametre.

Bu parametre ise true, hata ayıklama bilgileri ( . PDB dosyası) derleme sırasında yayılır. false varsayılan değerdir. Bu parametre, aspnet_compiler.exe dosyasındaki -d anahtarına karşılık gelir.
DelaySign İsteğe bağlı Boolean parametre.

Bu parametre ise true, derleme oluşturulduğunda tam olarak imzalanmaz.
FixedNames İsteğe bağlı Boolean parametre.

Bu parametre ise true, derlenen derlemelere sabit adlar verilir..
Force İsteğe bağlı Boolean parametre

Bu parametre ise true, görev zaten varsa hedef dizinin üzerine yazar. Mevcut içerik kaybolur. false varsayılan değerdir. Bu parametre, aspnet_compiler.exe dosyasındaki -f anahtarına karşılık gelir.
KeyContainer İsteğe bağlı String parametre.

Tanımlayıcı ad anahtarı kapsayıcısı belirtir.
KeyFile İsteğe bağlı String parametre.

Tanımlayıcı ad anahtar dosyasının fiziksel yolunu belirtir..
MetabasePath İsteğe bağlı String parametre.

Uygulamanın tam IIS metatabanı yolunu belirtir. Bu parametre veya PhysicalPath parametreleriyle VirtualPath birleştirilemez. Bu parametre, aspnet_compiler.exe dosyasındaki -m anahtarına karşılık gelir.
PhysicalPath İsteğe bağlı String parametre.

Derlenecek uygulamanın fiziksel yolunu belirtir. Bu parametre eksikse, uygulamayı bulmak için IIS metatabanı kullanılır. Bu parametre, aspnet_compiler.exe dosyasındaki -p anahtarına karşılık gelir.
TargetFrameworkMoniker İsteğe bağlı String parametre.

aspnet_compiler.exe dosyasının hangi .NET Framework sürümünün kullanılması gerektiğini belirten TargetFrameworkMoniker'i belirtir. Yalnızca .NET Framework takma adlarını kabul eder.
TargetPath İsteğe bağlı String parametre.

Uygulamanın derlendiği fiziksel yolu belirtir. Belirtilmezse, uygulama yerinde önceden derlenmiş olur.
Updateable İsteğe bağlı Boolean parametre.

Bu parametre ise true, önceden derlenmiş uygulama güncelleştirilebilir olacaktır. false varsayılan değerdir. Bu parametre, aspnet_compiler.exe üzerindeki -u anahtarına karşılık gelir.
VirtualPath İsteğe bağlı String parametre.

Derlenecek uygulamanın sanal yolu. Belirtilirse PhysicalPath , uygulamayı bulmak için fiziksel yol kullanılır. Aksi takdirde IIS metatabanı kullanılır ve uygulamanın varsayılan sitede olduğu varsayılır. Bu parametre, aspnet_compiler.exe dosyasındaki -v anahtarına karşılık gelir.

ToolTaskExtension parametreleri

Bu görev, sınıfından ToolTaskExtension devralan sınıfından ToolTask devralır ve sınıfından Task devralır. Bu devralma zinciri, görevlerden türetilen görevlere birkaç parametre ekler.

Aşağıdaki tabloda temel sınıfların parametreleri açıklanmaktadır:

Parametre Açıklama
EchoOff İsteğe bağlı bool parametre.

olarak trueayarlandığında, bu görev komut satırının stdout'a kopyalanmaması için cmd.exe komut satırına /Q geçirir.
EnvironmentVariables İsteğe bağlı String dizi parametresi.

Ortam değişkeni tanımlarının noktalı virgülle ayrılmış dizisi. Her tanım, eşittir işaretiyle ayrılmış bir ortam değişkeni adı ve değeri belirtmelidir. Bu değişkenler, normal ortam bloğuna ek olarak veya seçmeli olarak geçersiz kılmaya ek olarak oluşturulan yürütülebilir dosyaya geçirilir. Örneğin, Variable1=Value1;Variable2=Value2.
ExitCode İsteğe bağlı Int32 çıkış salt okunur parametresi.

Yürütülen komut tarafından sağlanan çıkış kodunu belirtir. Görev herhangi bir hata günlüğe kaydetmişse ancak işlem 0 çıkış koduna (başarılı) sahipse, bu -1 olarak ayarlanır.
LogStandardErrorAsError İsteğe bağlı bool parametre.

ise true, standart hata akışında alınan tüm iletiler hata olarak günlüğe kaydedilir.
StandardErrorImportance İsteğe bağlı String parametre.

Standart hata akışındaki metnin günlüğe kaydedildiği önem.
StandardOutputImportance İsteğe bağlı String parametre.

Standart çıkış akışındaki metnin günlüğe kaydedildiği önem.
Timeout İsteğe bağlı Int32 parametre.

Görev yürütülebilir dosyasının sonlandırıldığı süreyi milisaniye cinsinden belirtir. Varsayılan değer, zaman aşımı süresi olmadığını belirten değeridir Int.MaxValue. Zaman aşımı milisaniye cinsindendir.
ToolExe İsteğe bağlı string parametre.

Projeler bir ToolName'i geçersiz kılmak için bunu uygulayabilir. Görevler ToolName'i korumak için bunu geçersiz kılabilir.
ToolPath İsteğe bağlı string parametre.

Görevin temel alınan yürütülebilir dosyayı yüklediği konumu belirtir. Bu parametre belirtilmezse, görev MSBuild çalıştıran çerçevenin sürümüne karşılık gelen SDK yükleme yolunu kullanır.
UseCommandProcessor İsteğe bağlı bool parametre.

olarak trueayarlandığında, bu görev komut satırı için bir toplu iş dosyası oluşturur ve komutu doğrudan yürütmek yerine komut işlemcisini kullanarak yürütür.
YieldDuringToolExecution İsteğe bağlı bool parametre.

olarak trueayarlandığında bu görev, görevi yürütülürken düğümü verir.

Örnek

Aşağıdaki kod örneği, bir ASP.NET uygulamasını önceden derlemek için görevini kullanır AspNetCompiler .

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Target Name="PrecompileWeb">
        <AspNetCompiler
            VirtualPath="/MyWebSite"
            PhysicalPath="c:\inetpub\wwwroot\MyWebSite\"
            TargetPath="c:\precompiledweb\MyWebSite\"
            Force="true"
            Debug="true"
        />
    </Target>
</Project>

Ayrıca bkz.