Aracılığıyla paylaş

<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ıcı><destekleniyorRuntime>

Sözdizimi

<supportedRuntime version="runtime version" sku="SKU ID"/>

Attributes

Özellik Description
version İsteğe bağlı öznitelik.

Bu uygulamanın desteklediği ortak dil çalışma zamanının (CLR) sürümünü belirten 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 aracılığıyla "çalışma zamanı sürümü" değeri ana form alır. küçük.derleme. .NET Framework 4'le başlayarak, yalnızca ana ve ikincil sürüm numaraları gerekir ("v4.0.30319" yerine "v4.0"). Daha kısa dize önerilir.
Sku İsteğe bağlı öznitelik.

Bu uygulamanın hangi .NET Framework sürümünü desteklediğini belirten stok tutma birimini (SKU) belirten bir dize değeri.

.NET Framework 4.0'dan başlayarak özniteliğin 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

<supportedRuntime> öğesi uygulama yapılandırma dosyasında yoksa, uygulamayı derlemek için kullanılan çalışma zamanının sürümü kullanılır.

öğesi, çalışma zamanının <supportedRuntime> 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ü destekleyecek şekilde oluşturulmuş uygulamalar requiredRuntime< öğesini kullanmalıdır>.

Uyarı

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 sonraki sürümleri için ortak olan CLR sürümünü, özniteliği ise sku uygulamanın hedeflediği tek .NET Framework sürümünü gösterir.

özniteliğine <supportedRuntime>sku sahip öğe yapılandırma dosyasında varsa ve yüklenen .NET Framework sürümü belirtilen desteklenen sürümden düşükse, uygulama çalıştırılamaz ve bunun yerine desteklenen sürümü yüklemek 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'te 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.)

Uyarı

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şturulmuşsa ancak .NET Framework'ün önceki bir sürümüyle oluşturulmuş karma mod derlemesine bağımlıysa, desteklenen çalışma zamanları listesinde .NET Framework 4'ün belirtilmesi yeterli değildir. Ayrıca, <startup> yapılandırma dosyanızdaki öğesinde özniteliğini useLegacyV2RuntimeActivationPolicy olarak trueayarlamanız gerekir. Ancak bu özniteliği olarak true ayarlamak, .NET Framework'ün ö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ümleriyle test yapmanı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ğin ç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 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"

Example

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 .NET Framework 4.7'yi 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.

Ayrıca bakınız

  • Last updated on