<supportedRuntime> öğesi
Uygulamanın hangi ortak dil çalışma zamanı sürümünü ve isteğe bağlı olarak .NET Framework sürümünü desteklediğini belirtir.
<Yapılandırma>
<Başlangıç>
<supportedRuntime>
Syntax
<supportedRuntime version="runtime version" sku="SKU ID"/>
Öznitelikler
| Öznitelik | Açıklama |
|---|---|
| Sürüm | İsteğe bağlı öznitelik. Bu uygulamanın desteklediği ortak dil çalışma zamanı (CLR) sürümünü belirten bir dize değeri. Özniteliğin version geçerli değerleri için "çalışma zamanı sürümü" değerleri bölümüne bakın. Not: .NET Framework 3.5'e kadar "çalışma zamanı sürümü" değeri ana form alır. küçük.derleme. .NET Framework 4'ünden başlayarak yalnızca ana ve ikincil sürüm numaraları gereklidir ("v4.0.30319" yerine "v4.0"). Kısa dize önerilir. |
| Sku | İsteğe bağlı öznitelik. Bu uygulamanın hangi .NET Framework yayınını desteklediğini belirten stok tutma birimini (SKU) belirten bir dize değeri. .NET Framework 4.0'dan itibaren özniteliğinin sku kullanılması önerilir. Mevcut olduğunda, uygulamanın hedeflediğini .NET Framework sürümünü gösterir.Özniteliğin sku geçerli değerleri için "SKU Kimliği" değerleri bölümüne bakın. |
Açıklamalar
<Uygulama yapılandırma dosyasında supportedRuntime> öğesi yoksa, uygulamayı derlemek için kullanılan çalışma zamanının sürümü kullanılır.
supportedRuntime> öğesi, çalışma zamanının< 1.1 veya sonraki bir sürümü kullanılarak oluşturulan tüm uygulamalar tarafından kullanılmalıdır. Çalışma zamanının yalnızca 1.0 sürümünü desteklemek için oluşturulan uygulamalar requiredRuntime> öğesini kullanmalıdır<.
Not
Yapılandırma dosyasını belirtmek için CorBindToRuntimeByCfg işlevini kullanırsanız, çalışma zamanının <requiredRuntime> tüm sürümleri için öğesini kullanmanız gerekir. <supportedRuntime>CorBindToRuntimeByCfg kullandığınızda öğesi yoksayılır.
.NET Framework 1.1 ile 3.5 arasında çalışma zamanının sürümlerini destekleyen uygulamalar için, çalışma zamanının birden çok sürümü desteklendiğinde, ilk öğe çalışma zamanının en çok tercih edilen sürümünü, son öğe ise en az tercih edilen sürümü belirtmelidir. .NET Framework 4.0 veya sonraki sürümlerini destekleyen uygulamalar için özniteliği, version .NET Framework 4 ve üzeri sürümlerde ortak olan CLR sürümünü ve sku özniteliği ise uygulamanın hedeflediği tek .NET Framework sürümü gösterir.
yapılandırma dosyasında özniteliğine sahip skusupportedRuntime> öğesi varsa ve yüklü .NET Framework sürümü belirtilen desteklenen sürümden düşükse, uygulama çalıştırılamaz ve bunun yerine desteklenen sürümün yüklenmesini isteyen bir ileti< görüntüler. Aksi takdirde, uygulama yüklü herhangi bir sürümde çalıştırmayı dener, ancak bu sürümle tam olarak uyumlu değilse beklenmedik şekilde davranabilir. (.NET Framework sürümleri arasındaki uyumluluk farkları için bkz. .NET Framework uygulama uyumluluğu.) Bu nedenle, daha kolay hata tanılaması için bu öğeyi uygulama yapılandırma dosyasına eklemenizi öneririz. (Yeni proje oluşturulurken Visual Studio tarafından otomatik olarak oluşturulan yapılandırma dosyası zaten içeriyor.)
Not
Uygulamanız CorBindToRuntimeEx işlevi gibi eski etkinleştirme yollarını kullanıyorsa ve bu yolların önceki bir sürüm yerine CLR'nin 4. sürümünü etkinleştirmesini istiyorsanız veya uygulamanız .NET Framework 4 ile oluşturulduysa ancak .NET Framework önceki bir sürümüyle oluşturulmuş karma mod derlemesine bağımlıysa, Desteklenen çalışma zamanları listesinde 4'e .NET Framework. Ayrıca, <yapılandırma dosyanızdaki başlangıç> öğesinde özniteliğini useLegacyV2RuntimeActivationPolicy olarak trueayarlamanız gerekir. Ancak, bu özniteliği olarak true ayarlamak, .NET Framework önceki sürümleriyle oluşturulan tüm bileşenlerin, birlikte oluşturuldukları çalışma zamanları yerine .NET Framework 4 kullanılarak çalıştırıldığı anlamına gelir.
Uygulamaları üzerinde çalıştırabilecekleri tüm .NET Framework sürümleri ile sınamanızı öneririz.
"çalışma zamanı sürümü" değerleri
özniteliği, runtime belirli bir uygulama için gereken Ortak Dil Çalışma Zamanı (CLR) sürümünü belirtir. Tüm .NET Framework v4.x sürümleri CLR'yi v4.0 belirtir. Aşağıdaki tabloda özniteliğinin çalışma zamanı sürüm değeri için geçerli değerler version listelanmaktadır.
| .NET Framework sürümü | version özniteliği |
|---|---|
| 1.0 | "v1.0.3705" |
| 1.1 | "v1.1.4322" |
| 2.0 | "v2.0.50727" |
| 3.0 | "v2.0.50727" |
| 3,5 | "v2.0.50727" |
| 4.0-4.8.1 | "v4.0" |
"SKU Kimliği" değerleri
özniteliği, sku uygulamanın hedefleyip çalıştırması gereken .NET Framework sürümünü belirtmek için bir hedef çerçeve bilinen adı (TFM) kullanır. Aşağıdaki tabloda, .NET Framework 4'den başlayarak özniteliği tarafından sku desteklenen geçerli değerler listelenmektedir.
| .NET Framework sürümü | sku özniteliği |
|---|---|
| 4.0 | ". NETFramework,Version=v4.0" |
| 4.0, İstemci Profili | ". NETFramework,Version=v4.0,Profile=Client" |
| 4.0, platform güncelleştirmesi 1 | ". NETFramework,Version=v4.0.1" |
| 4.0, İstemci Profili, güncelleştirme 1 | ". NETFramework,Version=v4.0.1,Profile=Client" |
| 4.0, platform güncelleştirmesi 2 | ". NETFramework,Version=v4.0.2" |
| 4.0, İstemci Profili, güncelleştirme 2 | ". NETFramework,Version=v4.0.2,Profile=Client" |
| 4.0, platform güncelleştirmesi 3 | ". NETFramework,Version=v4.0.3" |
| 4.0, İstemci Profili, güncelleştirme 3 | ". NETFramework,Version=v4.0.3,Profile=Client" |
| 4,5 | ". NETFramework,Version=v4.5" |
| 4.5.1 | ". NETFramework,Version=v4.5.1" |
| 4.5.2 | ". NETFramework,Version=v4.5.2" |
| 4,6 | ". NETFramework,Version=v4.6" |
| 4.6.1 | ". NETFramework,Version=v4.6.1" |
| 4.6.2 | ". NETFramework,Version=v4.6.2" |
| 4.7 | ". NETFramework,Version=v4.7" |
| 4.7.1 | ". NETFramework,Version=v4.7.1" |
| 4.7.2 | ". NETFramework,Version=v4.7.2" |
| 4.8 | ". NETFramework,Version=v4.8" |
| 4.8.1 | ". NETFramework,Version=v4.8.1" |
Örnek
Aşağıdaki örnek, bir yapılandırma dosyasında desteklenen çalışma zamanı sürümünün nasıl belirtileceğini gösterir. Yapılandırma dosyası, uygulamanın 4.7 .NET Framework hedeflediğini gösterir.
<configuration>
<startup>
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.7" />
</startup>
</configuration>
Yapılandırma dosyası
Bu öğe, uygulama yapılandırma dosyasında kullanılabilir.
